Arachne at FreeLists---The Arachne Fan Club! Hmmm... I don't know, but all this extra documentation is beginning to sound like a "Users Manual" to me! That might be an OK idea, BUT...maybe that should be an optional item available for a nominal fee, because that is going to take more and more work on someone's part. I simply do not have time to do any type of writing at the moment, code or documentation. Sometimes too much information can result in information overload, and the user presents themselves with a blank expression, totally void of any response to stimuli. Also, F4 should be used VERY JUDICIOUSLY!!! Since that keystroke is what calls the editor, how many users will screw up what documentation they have, but don't want to read anyway??? C U L8R! Wiz <{;-) (this message "CC'd" to the Freelists group as well) In message , "Eric S. Emerson" <wildrice5@xxxxxxxx> writes: > > Hi Glennmcc, > All the pages and their respective uses > should be listed in a file somewhere, if they aren't > already. However, I would put descriptions in each > individual page also. It would be very easy and helpful > to "Press F4" and see a HELPFUL description of the > function of each page at the beginning of the source code. > However, it would not be an easy job to provide adequate > helpful descriptions in all cases. It would also be time > consuming. Such descriptions would also have to be > edited as changes were made in the pages.. > > Eric > > > >> On Sat, 28 May 2005 14:22:25 -0700 (PDT) "Glenn McCorkle" >> <glennmcc@xxxxxxxxxx> writes: >> > >> > >> > Ok, how about this as starter ? >> > >> > Right now, the 'title' section of each of Arachne's internally >> used >> > .HTM >> > files has within it information which identifies the purpose of >> that >> > specific page. >> > >> > What is we change the 'title ' of all of them like so........ >> > >> > <!--<TITLE>Arachne PPP Dialer</TITLE>--> >> > <TITLE>Press the F1 key for help....</TITLE> >> > >> > <!--<TITLE>Arachne Options</TITLE>--> >> > <TITLE>Press the F1 key for help....</TITLE> >> > >> > >> > We do this to _all_ of the included .HTM an .AH files. >> > >> > And then 'hidden' somewhere deep within the help files we place >> > a link to comments.txt >> > >> > ---- comments.txt ------ >> > >> > To remove this message (Press the F1 key for help....), >> > from the top of all of Arachne's included .HTM and .AH files.... >> > >> > Edit the file in question so that the top 2 lines >> > are changed as shown below. >> > >> > <!--<TITLE>Arachne PPP Dialer</TITLE>--> >> > <TITLE>Press the F1 key for help....</TITLE> >> > >> > <TITLE>Arachne PPP Dialer</TITLE> >> > <!--<TITLE>Press the F1 key for help....</TITLE>--> >> > >> > >> > When used within an HTML format page... <!-- and --> are the start >> >> > and >> > end tags of a 'commented-out section'. >> > >> > <!-- >> > everything inside of here has been ''commented-out' and will not >> > be shown when viewed in a file named as filename.HTM or >> filename.AH >> > --> >> > >> > Everything on this line would be shown because it is not enlcosed >> > within >> > <!-- and --> The 'and' at the start of this line would not be >> > shown. >> > >> > _______________________________ >> > >> > >> > We would place all of the above in a .TXT file so that none of >> those >> > <!-- --> sections would have any effect upon the displayed >> > information. >> > >> > -- >> > Glenn >> > > > [Sponsored by:] > _________________________________________________________________________ > ____ The newest lyrics on the Net! > > http://lyrics.astraweb.com > > Click NOW! > Wizard57M Glenn Gilbreath Jr. -- DOS Internet, Close Windows, Keep the Internet Open! -- Arachne at FreeLists -- Arachne, The Web Browser/Suite for DOS and Linux --