<!-- header_tag --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd"> <html> <!-- Copyright C 1999-2008 by the authors 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". --> <!-- Created on December 15, 2009 by texi2html 1.82 texi2html was written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> Olaf Bachmann <obachman@mathematik.uni-kl.de> and many others. Maintained by: Many creative people. Send bugs and suggestions to <texi2html-bug@nongnu.org> --> <head> <title>GNU LilyPond Contributor's Guide: 5.6 Updating LSR to a new version</title> <meta name="description" content="GNU LilyPond Contributor's Guide: 5.6 Updating LSR to a new version"> <meta name="keywords" content="GNU LilyPond Contributor's Guide: 5.6 Updating LSR to a new version"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="texi2html 1.82"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="index.es.html#index" rel="start" title="GNU LilyPond — Contributor's Guide"> <link href="index_toc.es.html#SEC_Contents" rel="contents" title="Table of Contents"> <link href="index_abt.es.html#SEC_About" rel="help" title="About This Document"> <link href="LSR-work.es.html#LSR-work" rel="up" title="5. LSR work"> <link href="Making-a-release.es.html#Making-a-release" rel="next" title="8.4 Making a release"> <link href="Fixing-snippets-in-LilyPond-sources.es.html#Fixing-snippets-in-LilyPond-sources" rel="previous" title="5.5 Fixing snippets in LilyPond sources"> <link rel="stylesheet" type="text/css" title="Patrick McCarty's design" href="lilypond-mccarty.css"> <link rel="alternate stylesheet" type="text/css" href="lilypond.css" title="Andrew Hawryluk's design"> <link rel="alternate stylesheet" type="text/css" href="lilypond-blue.css" title="Kurt Kroon's blue design"> <!--[if lte IE 7]> <link href="lilypond-ie-fixes.css" rel="stylesheet" type="text/css"> <![endif]--> </head> <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> <div id="main"> <a name="Updating-LSR-to-a-new-version"></a> <table class="nav_table"> <tr><td valign="middle" align="left" colspan="1">[<a href="LSR-work.es.html#LSR-work" title="Beginning of this chapter or previous chapter"> << LSR work </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#index" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.es.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.es.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Issues.es.html#Issues" title="Next chapter"> Issues >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="Fixing-snippets-in-LilyPond-sources.es.html#Fixing-snippets-in-LilyPond-sources" title="Previous section in reading order" accesskey="p" rel="previous"> < Fixing snippets in LilyPond sources </a>]</td><td valign="middle" align="center" colspan="1">[<a href="LSR-work.es.html#LSR-work" title="Up section" accesskey="u" rel="up"> Up : LSR work </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Issues.es.html#Issues" title="Next section in reading order" accesskey="n" rel="next"> Issues > </a>]</td></tr></table> <a name="Updating-LSR-to-a-new-version"></a> <h2 class="section">5.6 Updating LSR to a new version</h2> <p>To update LSR, perform the following steps: </p> <ol> <li> Download the latest snippet tarball, extract it, and run <code>convert-ly</code> on all files using the command-line option <code>--to=VERSION</code> to ensure snippets are updated to the correct stable version. </li><li> Copy relevant snippets (i.e., snippets whose version is equal to or less than the new version of LilyPond) from ‘<tt>input/new/</tt>’ into the tarball. <p>You must not rename any files during this, or the next, stage. </p> </li><li> Verify that all files compile with the new version of LilyPond, ideally without any warnings or errors. To ease the process, you may use the shell script that appears after this list. <p>Due to the workload involved, we <em>do not</em> require that you verify that all snippets produce the expected output. If you happen to notice any such snippets and can fix them, great; but as long as all snippets compile, don’t delay this step due to some weird output. If a snippet is broken, the hordes of willing web-2.0 volunteers will fix it. It’s not our problem. </p> </li><li> Create a tarball and send it back to Sebastiano. </li><li> When LSR has been updated, download another snippet tarball, verify that the relevant snippets from ‘<tt>input/new/</tt>’ were included, then delete those snippets from ‘<tt>input/new/</tt>’. </li></ol> <p>Here is a shell script to run all <code>.ly</code> files in a directory and redirect terminal output to text files, which are then searched for the word "failed" to see which snippets do not compile. </p> <blockquote><pre class="example">#!/bin/bash for LILYFILE in *.ly do STEM=$(basename "$LILYFILE" .ly) echo "running $LILYFILE..." lilypond --format=png -ddelete-intermediate-files "$LILYFILE" >& "$STEM".txt done grep failed *.txt </pre></blockquote> <hr size="6"> <table class="nav_table"> <tr><td valign="middle" align="left" colspan="1">[<a href="LSR-work.es.html#LSR-work" title="Beginning of this chapter or previous chapter"> << LSR work </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#index" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.es.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.es.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Issues.es.html#Issues" title="Next chapter"> Issues >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="Fixing-snippets-in-LilyPond-sources.es.html#Fixing-snippets-in-LilyPond-sources" title="Previous section in reading order" accesskey="p" rel="previous"> < Fixing snippets in LilyPond sources </a>]</td><td valign="middle" align="center" colspan="1">[<a href="LSR-work.es.html#LSR-work" title="Up section" accesskey="u" rel="up"> Up : LSR work </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Issues.es.html#Issues" title="Next section in reading order" accesskey="n" rel="next"> Issues > </a>]</td></tr></table> <!-- footer_tag --> <div class="footer"> <p class="footer_version"> This page is for LilyPond-2.12.3 (stable-branch). </p> <p class="footer_report"> Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome, please report errors to our <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">bug list</a>. </p> </div> <!-- FOOTER --> <!-- end div#main here --> </div> <div id="tocframe"> <p class="toc_uplink"><a href="../index.es.html" title="Documentation Index"><< Back to Documentation Index</a></p> <h4 class="toc_header"> <a href="index.es.html#index" title="Start of the manual">Contributor’s Guide</a></h4> <div class="contents"> <ul class="toc"> <li><a name="toc-Starting-with-git-1" href="Starting-with-git.es.html#Starting-with-git">1. Starting with git</a> <ul class="toc"> <li><a name="toc-Getting-the-source-code-1" href="Getting-the-source-code.es.html#Getting-the-source-code">1.1 Getting the source code</a> </li> <li><a name="toc-Updating-the-source-code-1" href="Updating-the-source-code.es.html#Updating-the-source-code">1.2 Updating the source code</a> </li> <li><a name="toc-Sharing-your-changes-1" href="Sharing-your-changes.es.html#Sharing-your-changes">1.3 Sharing your changes</a> </li> <li><a name="toc-Advanced-git-stuff-1" href="Advanced-git-stuff.es.html#Advanced-git-stuff">1.4 Advanced git stuff</a> </li> <li><a name="toc-Git-on-Windows-1" href="Git-on-Windows.es.html#Git-on-Windows">1.5 Git on Windows</a> </li> </ul> </li> <li><a name="toc-Compiling-LilyPond-1" href="Compiling-LilyPond.es.html#Compiling-LilyPond">2. Compiling LilyPond</a> <ul class="toc"> <li><a name="toc-Compiling-from-source-1" href="Compiling-from-source.es.html#Compiling-from-source">2.1 Compiling from source</a> </li> <li><a name="toc-Concurrent-Stable-and-Development-Versions-1" href="Concurrent-Stable-and-Development-Versions.es.html#Concurrent-Stable-and-Development-Versions">2.2 Concurrent Stable and Development Versions</a> </li> </ul> </li> <li><a name="toc-Documentation-work-1" href="Documentation-work.es.html#Documentation-work">3. Documentation work</a> <ul class="toc"> <li><a name="toc-Introduction-to-documentation-work-1" href="Introduction-to-documentation-work.es.html#Introduction-to-documentation-work">3.1 Introduction to documentation work</a> </li> <li><a name="toc-Documentation-suggestions-1" href="Documentation-suggestions.es.html#Documentation-suggestions">3.2 Documentation suggestions</a> </li> <li><a name="toc-Texinfo-introduction-and-usage-policy-1" href="Texinfo-introduction-and-usage-policy.es.html#Texinfo-introduction-and-usage-policy">3.3 Texinfo introduction and usage policy</a> </li> <li><a name="toc-Documentation-policy-1" href="Documentation-policy.es.html#Documentation-policy">3.4 Documentation policy</a> </li> <li><a name="toc-Tips-for-writing-docs-1" href="Tips-for-writing-docs.es.html#Tips-for-writing-docs">3.5 Tips for writing docs</a> </li> <li><a name="toc-Updating-doc-with-convert_002dly" href="Updating-docs-with-convert_002dly.es.html#Updating-docs-with-convert_002dly">3.6 Updating doc with <code>convert-ly</code></a> </li> <li><a name="toc-Translating-the-documentation-1" href="Translating-the-documentation.es.html#Translating-the-documentation">3.7 Translating the documentation</a> </li> </ul> </li> <li><a name="toc-Website-work-1" href="Website-work.es.html#Website-work">4. Website work</a> <ul class="toc"> <li><a name="toc-Introduction-to-website-work-1" href="Introduction-to-website-work.es.html#Introduction-to-website-work">4.1 Introduction to website work</a> </li> <li><a name="toc-Translating-the-website-1" href="Translating-the-website.es.html#Translating-the-website">4.2 Translating the website</a> </li> </ul> </li> <li class="toc_current"><a name="toc-LSR-work-1" href="LSR-work.es.html#LSR-work">5. LSR work</a> <ul class="toc"> <li><a name="toc-Introduction-to-LSR-1" href="Introduction-to-LSR.es.html#Introduction-to-LSR">5.1 Introduction to LSR</a> </li> <li><a name="toc-Adding-and-editing-snippets-1" href="Adding-and-editing-snippets.es.html#Adding-and-editing-snippets">5.2 Adding and editing snippets</a> </li> <li><a name="toc-Approving-snippets-1" href="Approving-snippets.es.html#Approving-snippets">5.3 Approving snippets</a> </li> <li><a name="toc-LSR-to-Git-1" href="LSR-to-Git.es.html#LSR-to-Git">5.4 LSR to Git</a> </li> <li><a name="toc-Fixing-snippets-in-LilyPond-sources-1" href="Fixing-snippets-in-LilyPond-sources.es.html#Fixing-snippets-in-LilyPond-sources">5.5 Fixing snippets in LilyPond sources</a> </li> <li class="toc_current"><a name="toc-Updating-LSR-to-a-new-version-1" href="Updating-LSR-to-a-new-version.es.html#Updating-LSR-to-a-new-version">5.6 Updating LSR to a new version</a> </li> </ul> </li> <li><a name="toc-Issues-1" href="Issues.es.html#Issues">6. Issues</a> <ul class="toc"> <li><a name="toc-Introduction-to-issues-1" href="Introduction-to-issues.es.html#Introduction-to-issues">6.1 Introduction to issues</a> </li> <li><a name="toc-Issue-classification-1" href="Issue-classification.es.html#Issue-classification">6.2 Issue classification</a> </li> <li><a name="toc-Adding-issues-to-the-tracker-1" href="Adding-issues-to-the-tracker.es.html#Adding-issues-to-the-tracker">6.3 Adding issues to the tracker</a> </li> </ul> </li> <li><a name="toc-Programming-work-1" href="Programming-work.es.html#Programming-work">7. Programming work</a> <ul class="toc"> <li><a name="toc-Overview-of-LilyPond-architecture-1" href="Overview-of-LilyPond-architecture.es.html#Overview-of-LilyPond-architecture">7.1 Overview of LilyPond architecture</a> </li> <li><a name="toc-LilyPond-programming-languages-1" href="LilyPond-programming-languages.es.html#LilyPond-programming-languages">7.2 LilyPond programming languages</a> </li> <li><a name="toc-Programming-without-compiling-1" href="Programming-without-compiling.es.html#Programming-without-compiling">7.3 Programming without compiling</a> </li> <li><a name="toc-Finding-functions-1" href="Finding-functions.es.html#Finding-functions">7.4 Finding functions</a> </li> <li><a name="toc-Code-style-1" href="Code-style.es.html#Code-style">7.5 Code style</a> </li> <li><a name="toc-Debugging-LilyPond-1" href="Debugging-LilyPond.es.html#Debugging-LilyPond">7.6 Debugging LilyPond</a> </li> </ul> </li> <li><a name="toc-Release-work-1" href="Release-work.es.html#Release-work">8. Release work</a> <ul class="toc"> <li><a name="toc-Development-phases-1" href="Development-phases.es.html#Development-phases">8.1 Development phases</a> </li> <li><a name="toc-Minor-release-checklist-1" href="Minor-release-checklist.es.html#Minor-release-checklist">8.2 Minor release checklist</a> </li> <li><a name="toc-Major-release-checklist-1" href="Major-release-checklist.es.html#Major-release-checklist">8.3 Major release checklist</a> </li> <li><a name="toc-Making-a-release-1" href="Making-a-release.es.html#Making-a-release">8.4 Making a release</a> </li> </ul> </li> </ul> </div> </div> </body> </html>