X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fcontributor.texi;h=ff39d7fafdd412675b3101bbfb10cd7af4d8356f;hb=47db9a3883d726ca53e2133a3b2298f78dd6a32e;hp=ec1954e12ade0315dc26f72310008ce25cd9cbe2;hpb=1c859650b6ff11a7dbe829328fd5cae3816b9231;p=lilypond.git

diff --git a/Documentation/contributor.texi b/Documentation/contributor.texi
index ec1954e12a..ff39d7fafd 100644
--- a/Documentation/contributor.texi
+++ b/Documentation/contributor.texi
@@ -3,103 +3,61 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
+
 @setfilename lilypond-contributor.info
-@settitle GNU LilyPond Contributor's Guide
+@settitle LilyPond Contributor's Guide
 @documentencoding UTF-8
 @documentlanguage en
+@afourpaper
+
+@macro manualIntro
+This manual documents contributing to LilyPond version
+@version{}.  It discusses technical issues and policies that
+contributors should follow.
+
+This manual is not intended to be read sequentially; new contributors
+should only read the sections which are relevant to them.  For more
+information about different jobs, see @rweb{Help us}.
+@end macro
+
+@c `Contributor’s Guide' was born 2007-09-15 with this commit:
+@c Add developers resources page
+@c author: John Mandereau
+@c commit: 135a5beef5c4cf893d02947cdfcb5bb90c854486
+@c   file: Documentation/devel.html.in
+
+@macro copyrightDeclare
+Copyright @copyright{} 2007--2015 by the authors.
+@end macro
 
+@set FDL
 @include macros.itexi
 
-@afourpaper
 
-@ifnottex
-@node Top
-@top GNU LilyPond --- Contributor's Guide
-@chapheading The music typesetter
-@end ifnottex
+@c don't remove this comment.
+@ignore
+@omfcreator LilyPond Development Team
+@omfdescription Contributor's Guide of the LilyPond music engraving system
+@omftype program usage
+@omfcategory Applications|Publishing
+@omflanguage English
+@end ignore
 
 
-@ifhtml
-@ifclear bigpage
-This document is also available as a
-@uref{source/Documentation/contributor.pdf,PDF} and as
-@c FIXME: update @uref{} stuff.
-@uref{source/Documentation/contributor-big-page.html,one big page}.
-@end ifclear
-@ifset bigpage
-This document is also available as a
-@uref{source/Documentation/devel/contributor.pdf,PDF} and as a
-@uref{source/Documentation/devel/contributor/index.html,HTML indexed multiple pages}.
-@end ifset
-@end ifhtml
-
-
-@iftex
-@exampleindent 0
-@finalout
-
-@titlepage
-@title LilyPond
-@subtitle The music typesetter
-@titlefont{Contributor's Guide}
-@author The LilyPond development team
-
-Copyright @copyright{} 1999--2008 by the authors
-
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-
-@vskip 20pt
-
-For LilyPond version
-@end titlepage
-@end iftex
-
-@copying
-Copyright @copyright{} 1999--2008 by the authors
-
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-@end copying
+@lilyTitlePage{Contributor's Guide}
 
-@ifnottex
-This file documents contributing to GNU LilyPond.
-
-Copyright 1999--2008 by the authors
-
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-@end ifnottex
 
+@c TOC -- non-tex
 @ifnottex
 
-More information can be found at
-@uref{http://@/www@/.lilypond@/.org/}.  The website contains
-on-line copies of this and other documentation.
-
 @menu
-* Starting with git::
-* Compiling LilyPond::
+* Introduction to contributing::
+* Quick start::
+* Working with source code::
+* Compiling::
 * Documentation work::
 * Website work::
 * LSR work::
@@ -107,12 +65,26 @@ on-line copies of this and other documentation.
 * Regression tests::
 * Programming work::
 * Release work::
+* Build system notes::
+* Modifying the feta font::
+* Administrative policies::
+
+Appendices
+
+* LilyPond grammar::
+* GNU Free Documentation License:: License of this document.
 @end menu
+
+@docMain
 @end ifnottex
 
 @contents
 
-@include contributor/git-starting.itexi
+@allowcodebreaks false
+
+@include contributor/introduction.itexi
+@include contributor/quick-start.itexi
+@include contributor/source-code.itexi
 @include contributor/compiling.itexi
 @include contributor/doc-work.itexi
 @include contributor/website-work.itexi
@@ -121,6 +93,18 @@ on-line copies of this and other documentation.
 @include contributor/regressions.itexi
 @include contributor/programming-work.itexi
 @include contributor/release-work.itexi
+@include contributor/build-notes.itexi
+@include contributor/feta-font.itexi
+@include contributor/administration.itexi
 
-@bye
+@node LilyPond grammar
+@appendix LilyPond grammar
+
+This appendix contains a description of the LilyPond grammar, as
+output from the parser.
+
+@verbatiminclude ly-grammar.txt
 
+@include fdl.itexi
+
+@bye