Grammar questions for documentation

David T. sunfish62 at yahoo.com
Wed Dec 1 14:51:19 EST 2010


Cristian--

I'm a little wary about global changes such as this. 

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]).

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