Webuilder 2014 inline todo/fixme/changed

Post your questions and problem reports here

Moderator: kfury77

Forum rules
Please try to follow these guidelines. This will help to receive faster and more accurate response.
  • Check the Support section of the corresponding product first. Chances are you will find your answer there;
  • Do not create new topics for already reported problems. Add your comments to the existing topics instead;
  • Create separate topic for each problem request. Do NOT post a number of non-related problem reports in a single topic;
  • Give your topic a meaningful title. Titles such as "A question," "Bug report" and "Help!" provide others no clue what your message is about;
  • Include the version number of the software you are using;
  • This is not an official customer support helpdesk. If you need a prompt and official response, please contact our support team directly instead. It may take a while until you receive a reply in the forum;
Post Reply
Distendo
Posts: 26
Joined: Mon May 28, 2012 10:04 pm

Webuilder 2014 inline todo/fixme/changed

Post by Distendo »

I have been trying to use the inline todo: fixme: and changed: feature in project files.

I'm obviously missing something 'cos it just doesn't seem to do anything except appear as (unformatted) text in browser view.

Pointers welcome.

WeBuilder v12.0.0.147
User avatar
Karlis
Site Admin
Posts: 3605
Joined: Mon Jul 15, 2002 5:24 pm
Location: Riga, Latvia, Europe
Contact:

Re: Webuilder 2014 inline todo/fixme/changed

Post by Karlis »

This is one of those features which if you do not understand how it works, then you most likely do not need it. It is not our invention it is more a standard.

The feature is described in the help file:
http://help.blumentals.net/webuilder/projects/todo.htm
Karlis Blumentals
Blumentals Software
www.blumentals.net
ted
Posts: 9
Joined: Sun Feb 10, 2013 4:08 pm

Re: Webuilder 2014 inline todo/fixme/changed

Post by ted »

I don't think that the reply by Karlis was particularly helpful.

To use TODO in code use

<?php // TODO: Need to fix this issue... ?>

or

<?php /* TODO: Need to fix this issue... */ ?>

To use TODO in html

<!-- TODO: Nee to fix this issue... -->

Neither will be rendered in your browser, but will be found from Project -> Project ToDo

HTH

Dave
Distendo
Posts: 26
Joined: Mon May 28, 2012 10:04 pm

Re: Webuilder 2014 inline todo/fixme/changed

Post by Distendo »

Hello Dave,

Thanks for the helpful reply: got it working now.

If the feature's description in the (not much) 'help' file Karlis mentioned - which I'd already found - hadn't omitted the essential code wrapper you identified (i.e. <!-- --> ), I wouldn't have needed to ask here. It may well be 'a standard' feature but clearly applicable documentation seems thin on the ground.

As to Karlis's "This is one of those features which if you do not understand how it works, then you most likely do not need it..." :P As I work on a project I maintain a line-number itemised list in a !ToDo.htm file in my html directory. Being able to jump from an automated list straight through to 'todo' line in the appropriate file is of great assistance. It was one of the first features of WeBuilder 2014 that I tried to implement.

Back in '95 I didn't understand html. A few years ago I didn't know any CSS, but now I use W3C CSS to check for typos. I'm still pretty basic with javascript and php, and quite frankly MySQL still lies beyond me, but it's never occurred to me that not understanding them (much) better means I have no need for them: it's a 'limitation', which I try to overcome.
Distendo
Posts: 26
Joined: Mon May 28, 2012 10:04 pm

Re: Webuilder 2014 inline todo/fixme/changed

Post by Distendo »

Just a couple of qs on the subj.

1) CHANGED: doesn't seem to work in the message list like TODO: and FIXME: . It shows, but without being flagged and headed 'CHANGED'. Any clues?

2) In my set-up the messages window truncates the entry's details: it only shows the first 22 characters of the file name & line number (in brackets). What I see looks like:

(FLAG)TODO
.
.....filename_123456.htm (1... # -->

Highlighting the entry shows a line after the 1... (.....filename_123456.htm (1...| # -->) like a column divider line, as if there should be some way to drag the column width wider. Is there any way to untruncate the view?
ted
Posts: 9
Joined: Sun Feb 10, 2013 4:08 pm

Re: Webuilder 2014 inline todo/fixme/changed

Post by ted »

Hi,

I can confirm that 'CHANGED' items do not appear in the same way that TODO and FIXME do i.e. with a flag. The interface should be consistent, so if this has not been raised as a bug, it should be.

In order to see more of your messages, why don't you do as I have and drag the messages window to the bottom of the screen where it will dock. It will then be full screen width. You can close the window when not in use as it will auto-reopen when needed.

With regards to your lack of programming knowledge, we all have to start somewhere, just keep plugging away :)

HTH

Dave
Distendo
Posts: 26
Joined: Mon May 28, 2012 10:04 pm

Re: Webuilder 2014 inline todo/fixme/changed

Post by Distendo »

Thanks for the follow-up, Dave.

Glad to hear it's not me that's responsible for the 'CHANGED' discrepancy.

I do have the message window docked at the bottom, so it is full-width, which makes me wonder why (to be more accurate) the filename associated with some TODO or FIXME is limited to around 12 lower-case or 10 uppercase characters before the line number (in brackets) is truncated. In fact the message itself is displayed in full.

BTW, my first experience of programming was in COBOL, on punched paper tape (honest), in the days well before PCs and hard drives. Every time one of my tapes was run through the machine (about the size of a fridge), it would throw a wobbler or seize up, need to be unplugged and reset. Maybe it's a case of keep unplugging away...
User avatar
Karlis
Site Admin
Posts: 3605
Joined: Mon Jul 15, 2002 5:24 pm
Location: Riga, Latvia, Europe
Contact:

Re: Webuilder 2014 inline todo/fixme/changed

Post by Karlis »

I confirm the bug with CHANGED:, will be corrected in the next update.
Karlis Blumentals
Blumentals Software
www.blumentals.net
biotech
Posts: 27
Joined: Mon Mar 09, 2009 10:08 pm

Re: Webuilder 2014 inline todo/fixme/changed

Post by biotech »

ted wrote:I don't think that the reply by Karlis was particularly helpful.

To use TODO in code use

<?php // TODO: Need to fix this issue... ?>

or

<?php /* TODO: Need to fix this issue... */ ?>

To use TODO in html

<!-- TODO: Nee to fix this issue... -->

Neither will be rendered in your browser, but will be found from Project -> Project ToDo

HTH

Dave
Thanks for this Dave.
It would be nice if this was in docs or if we got a command....such as 'Insert ToDo Comment' or something alike.
Post Reply