<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Other sources of information - GNU LilyPond Learning Manual</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond Learning Manual">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Further-tweaking.html#Further-tweaking" title="Further tweaking">
<link rel="prev" href="Using-variables-for-tweaks.html#Using-variables-for-tweaks" title="Using variables for tweaks">
<link rel="next" href="Avoiding-tweaks-with-slower-processing.html#Avoiding-tweaks-with-slower-processing" title="Avoiding tweaks with slower processing">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 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''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
hr { border:0; height:1; color: #000000; background-color: #000000; }
/* hr {
border: none;
height: 1px;
color: #666666;
background-color: #666666;
}
body {
border-left: 1px solid #666666;
border-right: 1px solid #666666;
color: #332d28;
margin-right: auto;
margin-left: auto;
width: 60em;
list-style-type: square;
font-family: Arial,Helvetica,sans-serif;
padding-right: 1em;
padding-left: 1em;
}
a {
border-bottom: 1px dashed #344242;
text-decoration: none;
color: #344242;
}
a:link {
text-decoration: none;
}
a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
a:active {
border-bottom: 1px solid #00cccc;
color: #00cccc;
}
a:hover {
border-bottom: 1px solid #1d7b85;
color: #1d7b85;
}
blockquote {
border: 1px solid #cccccc;
padding: 3px;
width: 40em;
}
.node {
border-left: 1px solid #666666;
margin: -0.5em 0px 1em;
padding: 2px 1px 0px;
font-style: italic;
}
.node a {
border: none;
text-decoration: underline;
font-style: normal;
font-weight: bold;
}
.verbatim {
font-family: "Courier New",Courier,monospace;
}
.unnumberedsubsubsec {
font-size: large;
color: #1d7b85;
}
.subsubheading {
font-size: large;
color: #3b220d;
}
.contents {
border: 1px dashed #339999;
margin: 3px 2em;
list-style-type: square;
padding-right: 1em;
width: 40em;
background-color: #fcfff9;
}
.contents a {
border-bottom: 1px dashed #423d34;
text-decoration: none;
color: #423d34;
}
.contents a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
.contents a:active {
border-bottom: 1px solid #f0d86d;
color: #f0d86d;
}
.contents a:hover {
border-bottom: 1px solid #3b220d;
color: #3b220d;
}
.menu {
border-left: 1px dashed #339999;
margin: 3px 2em 1em;
list-style-type: square;
padding-left: 1.4em;
width: 40em;
}
.unnumbered {
}
h2 {
font-size: x-large;
color: #1d7b85;
}
*/
--></style>
</head>
<BODY BGCOLOR=WHITE TEXT=BLACK>
<div class="node">
<p>
<a name="Other-sources-of-information"></a>
Next: <a rel="next" accesskey="n" href="Avoiding-tweaks-with-slower-processing.html#Avoiding-tweaks-with-slower-processing">Avoiding tweaks with slower processing</a>,
Previous: <a rel="previous" accesskey="p" href="Using-variables-for-tweaks.html#Using-variables-for-tweaks">Using variables for tweaks</a>,
Up: <a rel="up" accesskey="u" href="Further-tweaking.html#Further-tweaking">Further tweaking</a>
<hr>
</div>
<h4 class="subsection">4.6.3 Other sources of information</h4>
<p>The Internals Reference documentation contains a lot of information
about LilyPond, but even more information can be gathered by
looking at the internal LilyPond files. To explore these, you must
first find the directory appropriate to your system. The location
of this directory depends (a) on whether you obtained LilyPond
by downloading a precompiled binary from lilypond.org
or whether you installed it from a package manager (i.e.
distributed with Linux, or installed under fink or cygwin) or
compiled it from source, and (b) on which operating system it is
being used:
<p><strong>Downloaded from lilypond.org</strong>
<ul>
<li>Linux
<p>Navigate to
<samp><var>INSTALLDIR</var><span class="file">/lilypond/usr/share/lilypond/current/</span></samp>
<li>MacOS X
<p>Navigate to
<samp><var>INSTALLDIR</var><span class="file">/LilyPond.app/Contents/Resources/share/lilypond/current/</span></samp>
by either <code>cd</code>-ing into this directory from the
Terminal, or control-clicking on the LilyPond application and
selecting ‘Show Package Contents’.
<li>Windows
<p>Using Windows Explorer, navigate to
<samp><var>INSTALLDIR</var><span class="file">/LilyPond/usr/share/lilypond/current/</span></samp>
</ul>
<p><strong>Installed from a package manager or compiled from source</strong>
<p>Navigate to
<samp><var>PREFIX</var><span class="file">/share/lilypond/</span><var>X.Y.Z</var><span class="file">/</span></samp>, where
<var>PREFIX</var> is set by your package manager or <code>configure</code>
script, and <var>X.Y.Z</var> is the LilyPond version number.
<pre class="sp">
</pre>
<p>Within this directory the two interesting subdirectories are
<ul>
<li><samp><span class="file">ly/</span></samp> - contains files in LilyPond format
<li><samp><span class="file">scm/</span></samp> - contains files in Scheme format
</ul>
<p>Let's begin by looking at some files in <samp><span class="file">ly/</span></samp>.
Open <samp><span class="file">ly/property-init.ly</span></samp> in a text editor. The one
you normally use for <code>.ly</code> files will be fine. This file
contains the definitions of all the standard LilyPond built-in
commands, such as <code>\stemUp</code> and <code>\slurDotted</code>. You will
see that these are nothing more than definitions of variables
containing one or a group of <code>\override</code> commands. For
example, <code>/tieDotted</code> is defined to be:
<pre class="example">tieDotted = {
\override Tie #'dash-period = #0.75
\override Tie #'dash-fraction = #0.1
}
</pre>
<p>If you do not like the default values these built-in commands can
be redefined easily, just like any other variable, at the
head of your input file.
<p>The following are the most useful files to be found in
<samp><span class="file">ly/</span></samp>:
<p><table summary=""><tr align="left"><th valign="top" width="40%">Filename
</th><th valign="top" width="60%">Contents
<br></th></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">ly/engraver-init.ly</span></samp>
</td><td valign="top" width="60%">Definitions of engraver Contexts
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">ly/paper-defaults.ly</span></samp>
</td><td valign="top" width="60%">Specifications of paper-related defaults
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">ly/performer-init.ly</span></samp>
</td><td valign="top" width="60%">Definitions of performer Contexts
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">ly/property-init.ly</span></samp>
</td><td valign="top" width="60%">Definitions of all common built-in commands
<br></td></tr></table>
<p>Other settings (such as the definitions of markup commands) are
stored as <code>.scm</code> (Scheme) files. The Scheme programming
language is used to provide a programmable interface into
LilyPond internal operation. Further explanation of these files
is currently outside the scope of this manual, as a knowledge of
the Scheme language is required. Users should be warned that
a substantial amount of technical knowledge or time is required
to understand Scheme and these files (see <a href="Scheme-tutorial.html#Scheme-tutorial">Scheme tutorial</a>).
<p>If you have this knowledge, the Scheme files which may be of
interest are:
<p><table summary=""><tr align="left"><th valign="top" width="40%">Filename
</th><th valign="top" width="60%">Contents
<br></th></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">scm/auto-beam.scm</span></samp>
</td><td valign="top" width="60%">Sub-beaming defaults
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">scm/define-grobs.scm</span></samp>
</td><td valign="top" width="60%">Default settings for grob properties
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">scm/define-markup-commands.scm</span></samp>
</td><td valign="top" width="60%">Specify all markup commands
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">scm/midi.scm</span></samp>
</td><td valign="top" width="60%">Default settings for MIDI output
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">scm/output-lib.scm</span></samp>
</td><td valign="top" width="60%">Settings that affect appearance of frets, colors,
accidentals, bar lines, etc
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">scm/parser-clef.scm</span></samp>
</td><td valign="top" width="60%">Definitions of supported clefs
<br></td></tr><tr align="left"><td valign="top" width="40%"><samp><span class="file">scm/script.scm</span></samp>
</td><td valign="top" width="60%">Default settings for articulations
<br></td></tr></table>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Avoiding-tweaks-with-slower-processing.html#Avoiding-tweaks-with-slower-processing">Avoiding tweaks with slower processing</a>,
Previous: <a rel="previous" accesskey="p" href="Using-variables-for-tweaks.html#Using-variables-for-tweaks">Using variables for tweaks</a>,
Up: <a rel="up" accesskey="u" href="Further-tweaking.html#Further-tweaking">Further tweaking</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
This page is for LilyPond-2.11.57 (development-branch).
<br>
<address>
Report errors to <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a>. </address>
<br>
Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome.
</font>
</p>
</div>
<P>
Other languages: <a href="Other-sources-of-information.fr.html">français</a>, <a href="Other-sources-of-information.es.html">español</a>, <a href="Other-sources-of-information.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
