#5095 Doc: Inconsistent information with regard to stem.length's setting as measured in Staff spaces

On 19/02/17 19:26, Klaus Rettinghaus wrote:

Hi all,

Internals Reference says stem.length measures in staff spaces. But actually it goes by half staff spaces.
So either the documentation is wrong or this is a bug.

\version "2.18.2"

\relative {
\override Stem.length = 0 g'
\override Stem.length = 2 g
\override Stem.length = 4 g
\override Stem.length = 6 g
\override Stem.length = 8 g
\override Stem.length = 10 g
}

Regards
Klaus

[Anonymous]

Klaus Rettinghaus wrote:

Ok, here's another try:
(Version 2.19.56)

{
\override NoteHead.transparent = ##t
e'
\tweak Stem.length #3 e'
\tweak Stem.length #6 e'
}

The normal stem of an e' has the length of approximately 3 staff spaces. So I tweak the stem length to 3 (staff spaces) to match the previous. But it turns out to be only half as long. I have to tweak it to #6 to match a length of 3 staff spaces.
Where I'am thinking wrong?

Regards
Klaus

[Phil Holmes]

It appears that the documentation is autogenerated from a definition in define-grob-properties.scm:

(length ,ly:dimension? "User override for the stem length of unbeamed stems.")

so it's more likely a bug in the implementation. Might cause things to break if it were changed, though.

[Anonymous]

Doc: Internals - clarify stem-length is in half staff space units

Issue 5095
Clarify stem-length is in
half staff spaces.

Minor grammar and typo fixes
in auto-knee-gap, automatically-numbered,
and flexa-width.

http://codereview.appspot.com/560610043

[Anonymous]

Passes make, make check and a full make doc.

[Anonymous]

Patch on countdown for April 15th.

[Anonymous]

Patch counted down, please push to staging.

[Anonymous]

Doc: Internals - clarify stem-length is in half staff space units staging
author  James Lowe <pkx166h@runbox.com> 
    Mon, 15 Apr 2019 20:46:50 +0100 (20:46 +0100)
committer   James Lowe <pkx166h@runbox.com> 
    Mon, 15 Apr 2019 20:46:50 +0100 (20:46 +0100)
commit  ed0212b1dcf0b755810c0929cfdbe58ff649380f