Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 654187

Summary: Errors in Musician's Guide LilyPond section
Product: [Retired] Fedora Documentation Reporter: kalgynirae
Component: musicians-guideAssignee: Christopher Antila <christopher>
Status: CLOSED NEXTRELEASE QA Contact: Nobody's working on this, feel free to take it <nobody>
Severity: low Docs Contact:
Priority: low    
Version: develCC: eric, kwade
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-06-03 05:35:38 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Draft Correction christopher: review+

Description kalgynirae 2010-11-17 04:44:58 UTC
There are a couple of small errors in the LilyPond section of the Musician's Guide.

Section 12.4.7, last example: The explanation following the code example refers to a "violin" section, but in the code the section being referred to is actually called "something".

In the example, the variable "something" should be renamed to "violin" to match with the explanation.


Section 12.4.8.2, second example: The guide states: "The first bar has four half-notes, which is twice as many beats as are allowed. LilyPond will print a warning at the first bar-check symbol."

This is incorrect. The first bar-check will align with the second bar line and thus not produce any warning. The guide's interpretation of the bar-check symbol implies that you would have to put a bar-check at the end of every measure, which is not the case. The example should be modified so that it will actually produce a warning. A good example is "\time 4/4 c4 c2 c | c4 c2 c4 |" (in this hypothetical scenario, the third pitch's duration was mistakenly omitted, causing the bar-checks to fail.)

Comment 1 Christopher Antila 2010-11-19 06:05:38 UTC
I have inspected the document, and see that you're quite right about these errors.  My schedule is full for a few weeks, but I will make changes in December, and post here to let you see an updated version.  The corrections will be released with Fedora 15.

Thank you for your help in improving Fedora's documentation!  We welcome further feedback as a response to this bug.

Comment 2 Christopher Antila 2011-01-04 01:54:50 UTC
Created attachment 471567 [details]
Draft Correction

Please review the attached PDF file. It has a proposed resolution to the problems you reported. Please comment on whether the proposed resolution is acceptable, or you would like further changes.

Comment 3 kalgynirae 2011-01-04 02:17:25 UTC
I have reviewed the appropriate sections of the PDF, and it does indeed correct the errors.