On Wed, 2005-04-13 at 13:47 +0100, Alan Madden wrote: > 1) Put the variables for each function in italics. This is a standard > command syntax format, to indicate more clearly which part of the > command is used 'as is', and which parts are up to the user to fill in > themselves. > > 2) Similar to the first part, I went through and read which elements > in the functions were optional, and put square brackets around them, > so that to someone who is familiar with example syntax, they will be > able to quickly ascertain whether a variable is necessary or not.
Hi Alan, Thanks for your review, this is a massive chapter with room for many typos and formatting errors. What we are tying to do is explain the functions in a way that everyone can understand...you and I (being programmers) are used to brackets and other forms of emphasis in function syntax, but many spreadsheet users are not. My opinion is to leave the syntax as simple as possible and explain it fully in the description. I am sure many users will not understand why an argument is bracketed, but they will understand it when they read the description. This is the way the online help is written and I would like to be consistent, but I will bow to the will of the list... So what is the consensus? -- Regards, Rick Barnes www.nostabo.net ******************************************************************* PRIVILEGED - PRIVATE AND CONFIDENTIAL This electronic mail is solely for the use of the addressee and may contain information which is confidential or privileged. If you receive this electronic mail in error, please delete it from your system immediately and notify the sender by electronic mail or using any of the contact details noted herein. This e-mail sent via Evolution 2.0.4 running on a Linux 2.6.11 kernel.
signature.asc
Description: This is a digitally signed message part
