lilypond-devel
[Top][All Lists]
Advanced

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

Re: Use "simple strings" rather than #"hash-prefixed Scheme strings" (is


From: v . villenave
Subject: Re: Use "simple strings" rather than #"hash-prefixed Scheme strings" (issue 363910043 by address@hidden)
Date: Wed, 13 Feb 2019 23:56:09 -0800

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



reply via email to

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