1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
9 @include web/basic-authors.itexi
15 @divClass{column-center-top}
16 @subheading Interacting with the community
21 @ref{Contact}: get help, discuss, and keep in touch!
24 @ref{Tiny examples}: these are @emph{highly} recommended when
28 @ref{Bug reports}: something went wrong.
33 @divClass{column-left-bottom}
34 @subheading Making LilyPond better
39 @ref{Help us}: your assistance is requested.
42 @ref{Development}: for contributors and testers.
45 @ref{Authors}: the people who made LilyPond what it is today.
50 @divClass{column-right-bottom}
51 @subheading Miscellaneous
56 @ref{Publications}: what we wrote, and have had written about us.
59 @ref{Old news}: an archive.
80 @unnumberedsec Contact
83 @divClass{column-left-bottom}
84 @subheading User Discussions and Help
86 @subsubheading User mailing list: @code{lilypond-user@@gnu.org}
88 This mailing list is the main place for users to discuss and help
92 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-user,
93 lilypond-user subscribe and info}
95 @uref{http://lists.gnu.org/archive/html/lilypond-user/,
97 @uref{http://www.mail-archive.com/lilypond-user@@gnu.org/,
99 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.general,
102 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.general,
103 send to lilypond-user with gmane}
106 @warning{When asking questions, please use @ref{Tiny examples}!}
111 Some level of support is provided on our IRC channel,
114 @uref{irc://irc.freenode.net/lilypond, #lilypond@@irc.freenode.net}
117 This channel has no public archive, so any question that may
118 be useful for others would better be posted to one of the mailing lists.
121 <form action="http://webchat.freenode.net"
125 <input name="nick" type="text" size="15" value="">
127 <input name="channels" type="hidden" value="lilypond">
128 <input type="submit" value="Join #lilypond IRC Chat">
131 <script language="JavaScript" type="text/javascript">
132 var username = "web";
133 var lang = window.navigator.userLanguage ? window.navigator.userLanguage
134 : window.navigator.language;
135 username += '-' + lang.substr(0, 2);
136 username += '-' + navigator.appName.substr(0, 2);
137 username += navigator.appCodeName.replace (" ", "").substr(0, 2);
138 username += navigator.platform.replace (" ", "").replace("nux", "").replace("n32", "");
139 document.forms["f_lily_irc"].nick.value = username;
143 @subsubheading Other languages
146 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-es,
147 Spanish mailing list}
149 @uref{http://www.lilypondforum.de/,
152 @uref{http://groups.google.com/group/lilypond-brasil,
155 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-user-fr,
158 @uref{http://www.lilypondforum.nl/,
165 @divClass{column-right-top}
166 @subheading Stay Informed
168 @subsubheading LilyPond Report
170 The easiest way to keep touch is by reading our community
171 newsletter, the @uref{http://news.lilynet.net/, LilyPond Report}.
173 @subsubheading Releases mailing list: @code{info-lilypond@@gnu.org}
175 This mailing list is a low-volume, read-only list which receives
176 notifications of new releases.
179 @uref{http://lists.gnu.org/mailman/listinfo/info-lilypond,
180 info-lilypond subscribe and info}
182 @uref{http://lists.gnu.org/archive/html/info-lilypond/,
184 @uref{http://www.mail-archive.com/info-lilypond@@gnu.org/,
186 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.announce,
189 @c don't include gmane posting here. -gp
196 @divClass{column-right-bottom}
197 @subheading Developer Discussion
199 @subsubheading Developer mailing list: @code{lilypond-devel@@gnu.org}
201 Most developer discussion takes place on this list. Patches
205 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-devel,
206 lilypond-devel subscribe and info}
208 @uref{http://lists.gnu.org/archive/html/lilypond-devel/,
210 @uref{http://www.mail-archive.com/lilypond-devel@@gnu.org/,
212 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.devel,
215 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.devel,
216 send to lilypond-devel with gmane}
220 @subsubheading Bug mailing list: @code{bug-lilypond@@gnu.org}
222 Bug-specific discussion takes place here.
225 @uref{http://lists.gnu.org/mailman/listinfo/bug-lilypond,
226 bug-lilypond subscribe and info}
228 @uref{http://lists.gnu.org/archive/html/bug-lilypond/,
230 @uref{http://www.mail-archive.com/bug-lilypond@@gnu.org/,
232 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.bugs,
235 @c don't include gmane posting here. -gp
238 @warning{Before sending a message to the bug list, please read our
239 guidelines for @ref{Bug reports}.}
246 @unnumberedsec Tiny examples
248 @divClass{column-center-top}
249 @subheading What are @qq{Tiny examples}?
251 A tiny example is an example from which nothing can be removed.
254 @divClass{column-left-bottom}
255 @subheading Why create them?
257 @divClass{keep-bullets}
261 The simpler the example is, the quicker potential helpers can
262 understand it and help you.
265 A simple example demonstrates that you have put effort towards
266 solving the problem yourself. When people send huge portions of
267 input, it looks like they don't care how if we help them or not.
270 Creating a tiny example forces you to understand what is
271 happening. Many false problem reports can be avoided by
272 attempting to create a tiny example; if you cannot replicate a
273 @qq{bug} in a tiny example, then the problem was probably an
274 insufficient understanding of LilyPond, not an actual bug!
282 @divClass{column-right-bottom}
283 @subheading How do I create them?
285 @divClass{keep-bullets}
289 Include the \version number.
292 Make it small! Examples about spacing or page layout might
293 require many bars of music, but most issues can be reproduced
294 using only a single measure.
297 When trying to create an example, try commenting out @w{(@code{%}
298 or @code{%@{ @dots{} %@}})} sections of your file. If you can
299 comment something while still demonstrating the main idea, then
300 remove the commented-material!
303 Avoid using complicated notes, keys, or time signatures, unless
304 the bug is about the behavior of those items.
307 Do not use @code{\override} or @code{\set} commands unless the bug
308 is about those particular commands.
319 @unnumberedsec Bug reports
321 @divClass{column-center-top}
322 @subheading Step 1: Known bugs
324 If you have input that results in a crash or an erroneous output,
325 then that is a bug. There is a list of current bugs on our google
329 @uref{http://code.google.com/p/lilypond/issues/list}
332 @warning{Please @strong{DO NOT} add bug reports directly to the
333 bug tracker. Once an issue has been added to the tracker, feel
334 free to add more information to that report.}
339 @divClass{column-left-bottom}
340 @subheading Step 2: Creating a bug report
342 If you have discovered a bug which is not listed, please help us
343 by creating a bug report.
345 @warning{We only accept bug reports in the form of @ref{Tiny
346 examples}. We have very limited resources to deal with bug
347 reports, so any non-minimal example will be rejected. Almost
348 every bug can be demonstrated in four notes or less!}
350 Here is an example of a good bug report:
353 %% the octavation command doesn't
354 %% change the output at all!
357 \paper@{ ragged-right=##t @}
367 @divClass{column-right-bottom}
368 @subheading Step 3: Sending a bug report
370 Once you have verified that the issue is not already known and
371 created a bug report, please send it to us!
373 Unfortunately there is a strict @qq{no top-posting} check on the
374 bug list, which is often incorrectly triggered by lilypond files.
375 To avoid this, please add
378 > I'm not top posting.
382 (you must include the @code{>} ) to the top of your bug report.
384 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
385 Post with the gmane lilypond.bugs interface}, or send an email to
386 @uref{mailto:bug-lilypond@@gnu.prg, bug-lilypond@@gnu.org}.
388 Once your bug has been sent to the list, our Bug Meister will
389 examine the report. He may ask you for more information, or may
390 add the report to the tracker and let you know what the issue
393 You may mark the bug so that you automatically receive emails when
394 any activity on the bug occurs. This requires you have a google
400 @unnumberedsec Help us
402 @divClass{column-center-top}
403 @subheading We need you!
405 The LilyPond development team is quite small; we really want to
406 get more people involved. Please consider helping your fellow
407 LilyPond users by contributing to development!
409 Even working on small tasks can have a big impact: taking care
410 of them let experienced developers work on advanced tasks, instead
411 of spending time on those simple tasks.
416 @divClass{column-left-top}
417 @subheading Simple tasks
419 @divClass{keep-bullets}
423 Mailing list support: answer questions from fellow users.
426 Bug reporting: help users create proper @ref{Bug reports}, and aid
427 the Bug Team in handling @rcontrib{Issues}.
430 Documentation: small changes can be proposed by following the
431 guidelines for @rcontrib{Documentation suggestions}.
434 LilyPond Snippet Repository (LSR): create and fix snippets. See
435 @rcontrib{Adding and editing snippets}.
438 Discussions, reviews, and testing: the developers often ask for
439 feedback about new documentation, potential syntax changes, and
440 testing new features. Please contribute to these discussions!
444 @subheading Moderate tasks
446 @warning{These jobs generally require that you have the program
447 and documentation source files, but do not require a full
448 development environment. See @rcontrib{Starting with git}.}
453 @rcontrib{Documentation work}, and
454 @rcontrib{Building documentation without compiling LilyPond}.
457 Website: the website is built from the normal documentation
458 source. See the info about documentation, and also
459 @rcontrib{Website work}.
462 Translations: see @rcontrib{Translating the documentation}, and
463 @rcontrib{Translating the website}.
468 @subheading Complex tasks
470 @warning{These jobs generally require that you have the source
471 code and can compile LilyPond. See @rcontrib{Starting with git},
472 and @rcontrib{Compiling LilyPond}.}
474 We suggest that new contributors using Windows use a virtual
475 machine to run @emph{lilybuntu}. See
476 @rcontrib{Using a Virtual Machine to Compile LilyPond}.
480 Bugfixes, new features: the best way to begin is to join the
481 Frogs, and read @rcontrib{Programming work}.
489 @divClass{column-right-top}
494 Website and mailist: @uref{http://frogs.lilynet.net}
496 The Frogs are ordinary LilyPond users who have chosen to get
497 involved in their favorite software's development. Fixing bugs,
498 implementing new features, documenting the source code: there's a
499 lot to be done, but most importantly: this is a chance for
500 everyone to learn more about LilyPond, about Free Software, about
501 programming... and to have fun. If you're curious about any of
502 it, then the word is: @emph{Join the Frogs!}
506 @help{not active yet; either comment out or begin these projects
509 @subsubheading Grand LilyPond Input Syntax Standardization
511 Website: @uref{http://lilypond.org/~graham/gliss}
513 GLISS will stabilize the (non-tweak) input syntax for the upcoming
514 LilyPond 3.0. After updating to 3.0, the input syntax for
515 untweaked music will remain stable for the foreseeable future.
517 We will have an extensive discussion period to determine the final
520 @subsubheading Grand Organizing Project
522 Website and mailist: TODO
524 GOP is our big recruiting drive for new contributors.
530 @divClass{column-center-bottom}
531 @subheading Interested?
538 @unnumberedsec Development
540 @divClass{heading-center}
541 @heading Development materials for LilyPond @versionDevel{}
543 @warning{These are @emph{unstable development} versions. If you
544 have the slightest doubt about how to use or install LilyPond, we
545 urge you to use the stable @ref{Download}, and read the stable
550 @divClass{column-center-top}
551 @subheading Release numbers
553 There are two sets of releases for LilyPond: stable releases, and
554 unstable development releases. Stable versions have an
555 even-numbered @q{minor} version number (e.g., 2.8, 2.10, 2.12).
556 Development versions have an odd-numbered @q{minor} version number
557 (e.g., 2.7, 2.9, 2.11).
562 @divClass{column-left-top}
565 Instructions for git and compiling are in the Contributor's Guide.
568 @uref{http://git.sv.gnu.org/gitweb/?p=lilypond.git, lilypond git repository}
571 Documentation writers and testers will generally want to download
576 @downloadDevelLinuxNormal
578 @downloadDevelLinuxBig
580 @downloadDevelLinuxPPC
582 @downloadDevelFreeBSDNormal
584 @downloadDevelFreeBSDBig
586 @downloadDevelDarwinNormal
588 @downloadDevelDarwinPPC
590 @downloadDevelWindows
599 @divClass{column-right-top}
600 @subheading Contributor's Guide
602 LilyPond development is a fairly complicated matter. LilyPond is
603 a large, (mostly) stable project. In order to help new
604 contributors, and to keep the whole system (mostly) stable, we
605 have written a manual for contributors.
607 @docLinks{Contributor's Guide, contributor,
608 @rcontribnamed{Top,Contributor's Guide},
609 @manualDevelContributorSplit,
610 @manualDevelContributorBig, 500 kB,
611 @manualDevelContributorPdf, 2.8 MB}
616 @c if Downloads was a bit longer, and/or the CG was a bit shorter,
617 @c this would be great as column-right-top. -gp
618 @divClass{column-center-top}
619 @subheading Regression tests
621 @divClass{keep-bullets}
624 @item @uref{../../input/regression/collated-files.html, Regression tests}:
625 This release's tests. (also in
626 @uref{../input/regression/collated-files.pdf, pdf})
628 @item @uref{../../input/regression/musicxml/collated-files.html,
629 MusicXML Regression tests}:
630 This release's MusicXML tests. (also in
631 @uref{../input/regression/musicxml/collated-files.pdf, pdf})
633 @item @uref{http://lilypond.org/test, Archive of regression tests}:
634 Comparisons between versions.
642 @divClass{column-center-bottom}
645 @divClass{normal-table}
646 @multitable @columnfractions .3 .3 .3
647 @headitem Introduction
649 @manualDevelLearningSplit
651 @manualDevelLearningBig
653 @manualDevelLearningPdf
656 @manualDevelGlossarySplit
658 @manualDevelGlossaryBig
660 @manualDevelGlossaryPdf
663 @manualDevelEssaySplit
672 @manualDevelNotationSplit
674 @manualDevelNotationBig
676 @manualDevelNotationPdf
679 @manualDevelUsageSplit
686 @manualDevelSnippetsSplit
688 @manualDevelSnippetsBig
690 @manualDevelSnippetsPdf
702 @manualDevelChangesSplit
704 @manualDevelChangesBig
706 @manualDevelChangesPdf
709 @manualDevelExtendingSplit
711 @manualDevelExtendingBig
713 @manualDevelExtendingPdf
716 @manualDevelInternalsSplit
718 @manualDevelInternalsBig
720 @manualDevelInternalsPdf
731 @unnumberedsec Authors
733 @help{Under construction; this is not an accurate list!}
736 @divClass{column-left-top}
737 @subheading Current Development Team
739 @divClass{keep-bullets}
744 @divClass{column-right-top}
745 @subheading Previous Development Team
747 @divClass{keep-bullets}
753 @divClass{column-center-top}
754 @subheading Current Contributors
756 @divClass{keep-bullets}
757 @subsubheading Programming
765 @subsubheading Documentation
769 @subsubheading Support
773 @subsubheading Translation
781 @divClass{column-center-bottom}
782 @subheading Previous Contributors
784 @divClass{keep-bullets}
785 @subsubheading Programming
793 @subsubheading Documentation
797 @subsubheading Support
801 @subsubheading Translation
803 @translationsPrevious
811 @unnumberedsec Publications
813 @divClass{column-center-top}
814 @subheading What we wrote
816 @divClass{keep-bullets}
820 Han-Wen Nienhuys, @emph{LilyPond, Automated music formatting and
821 the Art of Shipping}. Forum Internacional Software Livre 2006
822 (FISL7.0) (@uref{http://lilypond.org/web/images/FISL7-slides.pdf,
826 Erik Sandberg, @emph{Separating input language and formatter in
827 GNU Lilypond}. Master's Thesis, Uppsala University, Department of
828 Information Technology March 2006.
829 (@uref{http://lilypond.org/web/images/thesis-erik-sandberg.pdf,
833 Han-Wen Nienhuys and Jan Nieuwenhuizen, @emph{LilyPond, a system
834 for automated music engraving}. Proceedings of the XIV Colloquium
835 on Musical Informatics (XIV CIM 2003), Firenze, Italy, May 2003.
836 (@uref{ http://lilypond.org/web/images/xivcim.pdf, PDF 95k})
844 @divClass{column-center-bottom}
846 @subheading What others wrote
848 @divClass{keep-bullets}
854 The German LinuxUser magazine wrote an
855 @uref{http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2009/10/Digitaler-Notenschluessel,
856 article about LilyPond}.
862 In @uref{http://www.musicbyandrew.ca/finale-lilypond-1.html,
863 articles on his personal site}, Andrew Hawryluk compares Finale
864 and LilyPond in general terms, and evaluates engraving
865 capabilities of both pieces of software in detail. The second
866 article is an instructive analysis of engraving issues in
867 Rachmaninoff's Piano Prelude No. 6, including comparisons with a
868 hand-engraved reference edition.
873 @uref{http://distrowatch.com,DistroWatch} awards LilyPond and
874 @uref{http://distrowatch.com/weekly.php?issue=20060605,writes}
875 @qq{Ladies and Gentleman, we are pleased to announce that, based
876 on readers' requests, the DistroWatch May 2006 donation has been
877 awarded to LilyPond (@euro{}190.00) and Lua (US$250.00).}
882 @uref{http://linuxjournal.com,Linux Journal} publishes an article
883 titled @uref{http://www.linuxjournal.com/article/8364, Make
884 Stunning Schenker Graphs with GNU LilyPond}. It is an in-depth
885 but hands-on feature article with crisp LilyPond graphics. Author
886 Kris Shaffer remarks @qq{GNU Lilypond generates beautiful graphics
887 that make commercial alternatives seem second-rate.}
892 The Belgian newspaper De Standaard investigates what drives Free
893 Software authors in an article titled
894 @uref{http://www.standaard.be/Artikel/Detail.aspx?artikelId=G42H5GD6,
895 Delen van KENNIS zonder WINSTBEJAG} (Non-profit sharing of
896 knowlegde) in its @q{DS2 bijlage}. LilyPond is used as an example
897 and the article is interspersed with quotes from an email
898 interview with Jan Nieuwenhuizen. This marks LilyPond's first
899 appearance in mainstream printed press.
904 A French article on the LilyPond 2.6 release appeared on
905 @uref{http://linuxfr.org/2005/06/27/19210.html, linuxfr.org}.
910 The editors of Computer!Totaal, a Dutch computer magazine,
911 @uref{http://lilypond.org/web/images/computer-totaal.jpeg,
912 describe LilyPond} in the October 2004 issue as: @qq{Wonderful
913 free (open source) software [..] The sheet music produced by
914 LilyPond is exceptionally pretty [..] a very powerful system that
915 can do almost anything.}
920 Dave Phillips wrote an introductory article for
921 @uref{http://linuxjournal.com,Linux Journal}: At
922 the sounding edge: LilyPond, parts
923 @uref{http://www.linuxjournal.com/article/7657, one} and
924 @uref{http://www.linuxjournal.com/article/7719, two}.
930 @uref{http://www.all-day-breakfast.com/cannam/linux-musician/lilypond.html,interviewed}
931 Han-Wen Nienhuys and Jan Nieuwenhuizen on linuxmusician.com
932 (original site defunct). This interview was also reviewed in a
933 @uref{http://slashdot.org/article.pl?sid=04/03/13/2054227&tid=,
939 Jazz singer Gail Selkirk writes about
940 @uref{http://www.songbirdofswing.com/editorial_page/lilypond/,
941 Diving into LilyPond}. @qq{... you can make lead sheets or full
942 orchestral parts, and the results can be stunning.}
943 @uref{http://www.computermusic.co.uk/, Computer Music Special},
953 @unnumberedsec Old news
955 @include web/news-front.itexi
957 @include web/news.itexi