Grammar questions for documentation

Cristian Marchi cri79 at libero.it
Wed Dec 1 15:04:40 EST 2010



Il 01/12/2010 20:51, David T. ha scritto:
> Cristian--
>
> I'm a little wary about global changes such as this.
>    
If you study all the possible cases, this could be a very helpful tool 
to support the maintaining of a big documentation like the GnuCash one.

> E.g., can you be certain that the character following a period is capitalized? (note the exception I provided in this sentence [i.e., you can't guarantee that this character is always capitalized]).
>    
Sure I can...you can exclude the case when you have only one letter (or 
a specific collection of characters, numbers, punctuations etc...) 
before the period.

> Similarly, while it was once a convention to have two spaces following a period at the end of a sentence, I believe that this is not so much the case any more--especially since the HTML age, where HTML drops extra spaces.
>
> David
>
>    



> --- On Wed, 12/1/10, Cristian Marchi<cri79 at libero.it>  wrote:
>
>    
>> From: Cristian Marchi<cri79 at libero.it>
>> Subject: Grammar questions for documentation
>> To: "GNUCASH devel"<gnucash-devel at gnucash.org>
>> Date: Wednesday, December 1, 2010, 11:04 AM
>> I'm working on some sed [1] commands
>> that do automatically some grammar corrections to xml file
>> (for documentation). For example I've a command that checks
>> (and if false corrects it) if after a period there are two
>> spaces, one removes the white spaces at the end of a line,
>> one checks and corrects for uppercase char after a period
>> and so on....
>>
>> Now I would like to know what you think about some of this
>> grammar and terminology conventions:
>>
>> - after a full stop (period) in the text there are always
>> two spaces before the following words (this is valid for
>> english and not for other languages i.e. Italian). [2]
>> - after a , ; : punctuation there is only a space before
>> the following word.
>> - toolbar, titlebar, menubar, summarybar, statusbar and not
>> tool bar, title bar etc... [3]
>> - the period after a phrase beetween parenthesis is inside
>> or outside the parenthesis?
>>
>> If you have other cases please let me know so I could
>> implement a command for them.
>>
>> All this command could be collected in a little script that
>> runs from time to time in the documentation for cleaning
>> purposes.
>>
>> Sorry if this topic is not really accounting or GnuCash
>> related...
>>
>> Regards
>> Cristian
>>
>>
>> [1] http://www.grymoire.com/Unix/Sed.html
>> [2] http://en.wikipedia.org/wiki/Full_stop
>> [3] http://library.gnome.org/devel/gdp-style-guide/stable/window-terminology.html.en
>>
>>
>> _______________________________________________
>> gnucash-devel mailing list
>> gnucash-devel at gnucash.org
>> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
>>
>>      
>
>
> .
>
>    


More information about the gnucash-devel mailing list