Grammar questions for documentation
cri79 at libero.it
Wed Dec 1 15:04:40 EST 2010
Il 01/12/2010 20:51, David T. ha scritto:
> 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.
> --- 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  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). 
>> - after a , ; : punctuation there is only a space before
>> the following word.
>> - toolbar, titlebar, menubar, summarybar, statusbar and not
>> tool bar, title bar etc... 
>> - 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
>> Sorry if this topic is not really accounting or GnuCash
>>  http://www.grymoire.com/Unix/Sed.html
>>  http://en.wikipedia.org/wiki/Full_stop
>>  http://library.gnome.org/devel/gdp-style-guide/stable/window-terminology.html.en
>> gnucash-devel mailing list
>> gnucash-devel at gnucash.org
More information about the gnucash-devel