Reviewers: carl.d.sorensen_gmail.com, thomasmorley651, dak,
Message:
On 2019/02/10 19:59:36, dak wrote:
>> Simple strings -- don't need #
>
> In markup-mode they do
Not in current master.
Yes; that’s what motivated this proposal in the first place.
Look, putting strings between double quotes is certainly one of the most
basic things a non-technical user can grasp; not having to prefix them
with # (and not having to _understand_ why they should be) is one of
those changes that seem trivial to many of us but actually considerably
lower the entry barrier for beginners.
If you need to look at but one file in this patch, check out
doc/learning/fundamental.itely:
-LilyPond's primary expressions are musical items like notes,
-durations, and markups. More basic expressions like numbers,
-strings, and lists are processed in @q{Scheme mode}, which is
-invoked by prefixing the value with @samp{#}. Although the
-values may sometimes have a valid representation in LilyPond's
-musical mode, this manual will always use @samp{#} for their
-entry for the sake of consistency.
+LilyPond's primary expressions are musical items like notes and
+durations, as well as strings and markups. More specific expressions
+like numbers, symbols and lists are processed in @q{Scheme mode}, which
is
+invoked by prefixing the value with @samp{#}.
V.
Description:
Use "simple strings" rather than #"hash-prefixed Scheme strings"
Now that the user-exposed syntax hardly requires #-prefixed
string arguments anymore, we can do away with that syntax
through various places as well (particularly the LM, where
it may make things slightly less confusing for newcomers).
This commit leaves LSR-imported snippets untouched for now.
Please review this at https://codereview.appspot.com/363910043/
Affected files (+1606, -1609 lines):
M Documentation/ca/learning/fundamental.itely
M Documentation/ca/learning/tweaks.itely
M Documentation/ca/notation/pitches.itely
M Documentation/ca/notation/staff.itely
M Documentation/contributor/doc-work.itexi
M Documentation/cs/learning/fundamental.itely
M Documentation/cs/learning/tweaks.itely
M Documentation/de/essay/engraving.itely
M Documentation/de/learning/fundamental.itely
M Documentation/de/learning/tweaks.itely
M Documentation/de/notation/changing-defaults.itely
M Documentation/de/notation/chords.itely
M Documentation/de/notation/fretted-strings.itely
M Documentation/de/notation/input.itely
M Documentation/de/notation/percussion.itely
M Documentation/de/notation/pitches.itely
M Documentation/de/notation/spacing.itely
M Documentation/de/notation/staff.itely
M Documentation/de/notation/text.itely
M Documentation/de/notation/vocal.itely
M Documentation/es/changes.tely
M Documentation/es/essay/engraving.itely
M Documentation/es/learning/fundamental.itely
M Documentation/es/learning/tweaks.itely
M Documentation/es/notation/ancient.itely
M Documentation/es/notation/changing-defaults.itely
M Documentation/es/notation/chords.itely
M Documentation/es/notation/fretted-strings.itely
M Documentation/es/notation/input.itely
M Documentation/es/notation/percussion.itely
M Documentation/es/notation/pitches.itely
M Documentation/es/notation/spacing.itely
M Documentation/es/notation/staff.itely
M Documentation/es/notation/text.itely
M Documentation/es/notation/vocal.itely
M Documentation/essay/engraving.itely
M Documentation/fr/changes.tely
M Documentation/fr/essay/engraving.itely
M Documentation/fr/learning/fundamental.itely
M Documentation/fr/learning/tweaks.itely
M Documentation/fr/notation/ancient.itely
M Documentation/fr/notation/changing-defaults.itely
M Documentation/fr/notation/chords.itely
M Documentation/fr/notation/fretted-strings.itely
M Documentation/fr/notation/input.itely
M Documentation/fr/notation/percussion.itely
M Documentation/fr/notation/pitches.itely
M Documentation/fr/notation/spacing.itely
M Documentation/fr/notation/staff.itely
M Documentation/fr/notation/text.itely
M Documentation/fr/notation/vocal.itely
M Documentation/hu/essay/engraving.itely
M Documentation/hu/learning/fundamental.itely
M Documentation/included/chord-names-languages.ly
M Documentation/included/display-predefined-string-tunings.ly
M Documentation/included/gonville.ly
M Documentation/it/changes.tely
M Documentation/it/essay/engraving.itely
M Documentation/it/learning/fundamental.itely
M Documentation/it/learning/tweaks.itely
M Documentation/it/notation/changing-defaults.itely
M Documentation/it/notation/input.itely
M Documentation/it/notation/pitches.itely
M Documentation/it/notation/spacing.itely
M Documentation/it/notation/staff.itely
M Documentation/it/notation/text.itely
M Documentation/it/notation/vocal.itely
M Documentation/ja/learning/fundamental.itely
M Documentation/ja/learning/tweaks.itely
M Documentation/ja/notation/changing-defaults.itely
M Documentation/ja/notation/chords.itely
M Documentation/ja/notation/fretted-strings.itely
M Documentation/ja/notation/input.itely
M Documentation/ja/notation/percussion.itely
M Documentation/ja/notation/pitches.itely
M Documentation/ja/notation/spacing.itely
M Documentation/ja/notation/staff.itely
M Documentation/ja/notation/text.itely
M Documentation/ja/notation/vocal.itely
M Documentation/learning/fundamental.itely
M Documentation/learning/tweaks.itely
M Documentation/ly-examples/cary.ly
M Documentation/ly-examples/tab-example.ly
M Documentation/music-glossary.tely
M Documentation/nl/learning/fundamental.itely
M Documentation/nl/learning/tweaks.itely
M Documentation/notation/ancient.itely
M Documentation/notation/changing-defaults.itely
M Documentation/notation/chords.itely
M Documentation/notation/fretted-strings.itely
M Documentation/notation/input.itely
M Documentation/notation/pitches.itely
M Documentation/notation/spacing.itely
M Documentation/notation/staff.itely
M Documentation/notation/text.itely
M Documentation/notation/vocal.itely
M Documentation/snippets/new/adding-drum-parts.ly
M Documentation/snippets/new/combining-two-parts-on-the-same-staff.ly
M Documentation/snippets/new/incipit.ly
M Documentation/snippets/new/jazz-combo-template.ly
M Documentation/snippets/new/orchestra,-choir-and-piano-template.ly
M Documentation/snippets/new/piano-template-simple.ly
M Documentation/snippets/new/quoting-another-voice.ly
M Documentation/snippets/new/quoting-another-voice-with-transposition.ly
M
Documentation/snippets/new/replacing-default-midi-instrument-equalization.ly
M Documentation/snippets/new/unfretted-headword.ly
M input/regression/alignment-order.ly
M input/regression/ambitus-cue.ly
M input/regression/chord-additional-pitch-prefix.ly
M input/regression/chord-name-override-text.ly
M input/regression/chord-names-languages.ly
M input/regression/chromatic-scales.ly
M input/regression/clip-systems.ly
M input/regression/cue-clef.ly
M input/regression/cue-clef-after-barline.ly
M input/regression/cue-clef-begin-of-score.ly
M input/regression/cue-clef-keysignature.ly
M input/regression/cue-clef-new-line.ly
M input/regression/cue-clef-transposition.ly
M input/regression/cue-clef-transposition-optional.ly
M input/regression/dead-notes.ly
M input/regression/display-lily-tests.ly
M input/regression/double-repeat-default-volta.ly
M input/regression/dynamics-context-textspan.ly
M input/regression/filter-translators.ly
M input/regression/font-name.ly
M input/regression/fret-diagrams-fret-label.ly
M input/regression/fret-diagrams-xo-label.ly
M input/regression/id.ly
M input/regression/incipit.ly
M input/regression/instrument-name-groups.ly
M input/regression/instrument-name-hara-kiri.ly
M input/regression/instrument-name-pedal-lyrics.ly
M input/regression/instrument-name-volta.ly
M input/regression/instrument-switch.ly
M input/regression/les-nereides.ly
M input/regression/line-arrows.ly
M input/regression/markup-eps.ly
M input/regression/markup-rest.ly
M input/regression/markup-syntax.ly
M input/regression/markup-user.ly
M input/regression/midi-volume-equaliser.ly
M input/regression/mozart-hrn3-defs.ily
M input/regression/ottava.ly
M input/regression/page-breaks.ly
M input/regression/predefined-fretboards.ly
M input/regression/property-nested-override.ly
M input/regression/quote.ly
M input/regression/quote-cue-during.ly
M input/regression/quote-cyclic.ly
M input/regression/quote-during.ly
M input/regression/quote-during-subvoice.ly
M input/regression/quote-grace.ly
M input/regression/quote-kill-cues.ly
M input/regression/quote-overrides.ly
M input/regression/quote-transposition.ly
M input/regression/quote-tuplet.ly
M input/regression/quote-tuplet-end.ly
M input/regression/repeat-percent-kerning.ly
M input/regression/song-associated-voice.ly
M input/regression/song-basic.ly
M input/regression/song-basic-nonenglish.ly
M input/regression/song-breathe.ly
M input/regression/song-melisma.ly
M input/regression/song-reordering.ly
M input/regression/song-reordering2.ly
M input/regression/song-repetition.ly
M input/regression/song-skip.ly
M input/regression/song-skip-noword.ly
M input/regression/song-slurs.ly
M input/regression/song-splitpart.ly
M input/regression/song-stanzas.ly
M input/regression/song-tempo.ly
M input/regression/spacing-non-adjacent-columns3.ly
M input/regression/tag-filter.ly
M input/regression/text-spanner.ly
M ly/engraver-init.ly
M ly/festival.ly
M ly/grace-init.ly
M ly/performer-init.ly
M ly/predefined-guitar-fretboards.ly
M ly/predefined-guitar-ninth-fretboards.ly
M ly/predefined-mandolin-fretboards.ly
M ly/predefined-ukulele-fretboards.ly
M python/musicexp.py
_______________________________________________
lilypond-devel mailing list
lilypond-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-devel