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<cr...@libero.it> wrote:
From: Cristian Marchi<cr...@libero.it>
Subject: Grammar questions for documentation
To: "GNUCASH devel"<gnucash-devel@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@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
.
_______________________________________________
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
