[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: glossary - add 'high bass clef'

From: ArnoldTheresius
Subject: Re: glossary - add 'high bass clef'
Date: Tue, 23 Oct 2012 04:54:08 -0700 (PDT)

James wrote
> Hello,
> ...
> Well I have applied this patch and I am not sure it is appropriate for
> the glossary, perhaps the explanation, but the example is far too
> complex for our documentation - perhaps as a snippet maybe.
> Also you have not followed really any of our style guidelines in the
> Contributor's Guide (line lengths, texinfo syntax, @lilypond
> [variables] etc. so there is still a fair amount of work to do here
> before it will even be considered.
> So, I can do this for you (shepherd your patch) or you are more than
> welcome to use our git-cl and patch review process yourself until you
> need to push it, when you will need to prepare a properly formatted
> git patch that is easy to apply etc (i notice your $LILYPOND_GIT
> variable is not the standard one, making it slightly more work for
> those that need to apply it - I am no expert but managed to work it
> out). I don't want to discourage you from submitting patches, but we
> do have a well defined (if slightly idiosyncratic work-flow - so I am
> told, I only know LilyPond so cannot comment)
> If you do choose to do this yourself you should read our Contributor's
> Guide and follow the style guidelines there, and I suggest that you
> take the huge example out, cut it right back as you can and include it
> as a snippet.
> See:
> http://lilypond.org/doc/v2.16/Documentation/contributor/documentation-work
> and
> http://lilypond.org/doc/v2.16/Documentation/contributor/summary-for-experienced-developers
> (the reviews section specifically).
> James
> _______________________________________________
> bug-lilypond mailing list

> bug-lilypond@

> https://lists.gnu.org/mailman/listinfo/bug-lilypond


I noticed, the example is quite huge. But I'm not sure, can it be understood
without example?
If so, we can completely remove the snippets.

I think the line length of 80 characters was succeded only in the

What could a 'separate snippet' want to tell? Perhaps "How to build a pitch
usage chart manually".

I did try to use only the syntax I found in the '.tely' file, but I did not
look (deeply) into the documentation contributors guide. Sorry for that.

To upload contributions by myself: My computer I'm working with lilypond is
not connected to any network. (For that reason I prefer the PDF of the
handbooks to the HTML version) So at first I'll need to find some
description how to operate this in a 'package mode', i.e. GIT-access (in a
HTML browser) at one computer, transfer files to and from the working
computer (the most easy step), import and export the file packages in the
working computers lilydev VM.
Do you know where such an description is?


View this message in context: 
Sent from the Bugs mailing list archive at Nabble.com.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]