lilypond-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

second thoughts about @samp{}


From: Graham Percival
Subject: second thoughts about @samp{}
Date: Fri, 12 Oct 2007 14:01:13 -0700
User-agent: Icedove 1.5.0.12 (X11/20070607)

I'm having second thoughts about using @samp{} for small input. For example, consider "absolute octave entry" (in 1.1.1)

http://opihi.cs.uvic.ca/~gperciva/lilypond/Documentation/user/lilypond/Absolute-octave-entry.html

The problem is that we use ' as part of the lilypond language. IMO, we shouldn't use @samp{} for the "lowercase letters a through g", since that might confuse people with octave marks.

Lower on the page, we discuss using single quote (`'') or comma (`,') characters. I think that we wouldn't lose any clarity -- and possibly add some -- if we simply write

"single quote (') or comma (,)"

(ie if we use @code{} for all input, regardless of short lengths)


As an added bonus, this clarifies the instructions for doc writers: put all lilypond input in @code{}.

Cheers,
- Graham




reply via email to

[Prev in Thread] Current Thread [Next in Thread]