Doc: CG remove ugly bars at end of lines in doc

Doc: CG remove ugly bars at end of lines in doc

Caused by 'too long' lines in tely/texi files.

Using a variety of methods to break lines that are not normally broken

use @smallexample or ' \ ' in the case of long CLI syntax

Tracker issue 1691

Some minor text edits to also accommodate the lines lengths.
No new information added, some URLs that I couldn't shrink down
enough have been edited so that the information is still correct
but there are less 'arguments' in the URL itself (i.e. for filtering
on google.code.

[Graham Percival (old account), 2011-06-25 16:12:02]

mostly fine, but a few problems that definitely shouldn't be pushed.

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
File Documentation/contributor/build-notes.itexi (right):

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:445: LOOP=+$(foreach i, $(SUBDIRS),
$(MAKE) PACKAGE=$(PACKAGE) \
I don't think you should change any example showing exact lines from files.

Make this @smallexample, but if that still exceeds the line width, leave it
alone.

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:589: Found prerequisite
`out-www/version.itexi' as VPATH \
ditto

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:614: $(outdir)/%.texi:
$(outdir)/%.tely $(outdir)/version.itexi \
ditto

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:627: $(outdir)/%.texi:
$(outdir)/%.tely $(outdir)/version.itexi \
ditto

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:643: LILYPOND_VERSION=2.15.0
/usr/bin/python   --process=' ' \
this is ok, since it's "the exact input turns into this command".

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/progra...
File Documentation/contributor/programming-work.itexi (right):

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/progra...
Documentation/contributor/programming-work.itexi:405: set statusline=%F%m%r%h%w\
%{&ff}\ %Y\ [ASCII=\%03.3b]\ /
I'm not certain if .vimrc files allow \ continuations.  Could you either look it
up, or remove this if you're at all uncertain?

[pkx166h, 2011-06-26 00:02:00]

2nd Draft. Thanks for the comments Graham.

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
File Documentation/contributor/build-notes.itexi (right):

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:445: LOOP=+$(foreach i, $(SUBDIRS),
$(MAKE) PACKAGE=$(PACKAGE) \
On 2011/06/25 16:12:02, Graham Percival wrote:
> I don't think you should change any example showing exact lines from files.
> 
> Make this @smallexample, but if that still exceeds the line width, leave it
> alone.

Done.

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:589: Found prerequisite
`out-www/version.itexi' as VPATH \
On 2011/06/25 16:12:02, Graham Percival wrote:
> ditto

Done.

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:614: $(outdir)/%.texi:
$(outdir)/%.tely $(outdir)/version.itexi \
On 2011/06/25 16:12:02, Graham Percival wrote:
> ditto

Done.

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/build-...
Documentation/contributor/build-notes.itexi:627: $(outdir)/%.texi:
$(outdir)/%.tely $(outdir)/version.itexi \
On 2011/06/25 16:12:02, Graham Percival wrote:
> ditto

Done.

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/progra...
File Documentation/contributor/programming-work.itexi (right):

http://codereview.appspot.com/4641074/diff/1/Documentation/contributor/progra...
Documentation/contributor/programming-work.itexi:405: set statusline=%F%m%r%h%w\
%{&ff}\ %Y\ [ASCII=\%03.3b]\ /
On 2011/06/25 16:12:02, Graham Percival wrote:
> I'm not certain if .vimrc files allow \ continuations.  Could you either look
it
> up, or remove this if you're at all uncertain?

Took 10 mins on Google, it wasn't that clear to me. So I've reverted it and use
@smallexample

[Graham Percival (old account), 2011-06-26 11:48:45]

some more little problems.

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/bui...
File Documentation/contributor/build-notes.itexi (right):

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/bui...
Documentation/contributor/build-notes.itexi:679: $(LYS_TO_TELY)
--name=$(outdir)/collated-files.tely \
oops, I missed this one.  Please only make this @smallexample but leave the text
alone.

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/bui...
Documentation/contributor/build-notes.itexi:714: $(PYTHON)
$(top-src-dir)/scripts/build/create-version-itexi.py > $@
the tab is important in a makefile; don't change this example.  Go ahead and
make it @smallexample.

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/pro...
File Documentation/contributor/programming-work.itexi (right):

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/pro...
Documentation/contributor/programming-work.itexi:404: set statusline=%F%m%r%h%w\
%{&ff}\ %Y\ [ASCII=\%03.3b]\ /
I thought you weren't going to change this line after all?

[pkx166h, 2011-06-26 14:05:12]

Third Draft - Thanks again Graham.


James

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/bui...
File Documentation/contributor/build-notes.itexi (right):

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/bui...
Documentation/contributor/build-notes.itexi:679: $(LYS_TO_TELY)
--name=$(outdir)/collated-files.tely \
On 2011/06/26 11:48:45, Graham Percival wrote:
> oops, I missed this one.  Please only make this @smallexample but leave the
text
> alone.

Done.

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/bui...
Documentation/contributor/build-notes.itexi:714: $(PYTHON)
$(top-src-dir)/scripts/build/create-version-itexi.py > $@
On 2011/06/26 11:48:45, Graham Percival wrote:
> the tab is important in a makefile; don't change this example.  Go ahead and
> make it @smallexample.

Done.

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/pro...
File Documentation/contributor/programming-work.itexi (right):

http://codereview.appspot.com/4641074/diff/5001/Documentation/contributor/pro...
Documentation/contributor/programming-work.itexi:404: set statusline=%F%m%r%h%w\
%{&ff}\ %Y\ [ASCII=\%03.3b]\ /
On 2011/06/26 11:48:45, Graham Percival wrote:
> I thought you weren't going to change this line after all?

Done.

[Graham Percival (old account), 2011-06-26 14:12:47]

ok, push it.