[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 13/35: glilypond(1): Fix content, style, markup problems.
From: |
G. Branden Robinson |
Subject: |
[groff] 13/35: glilypond(1): Fix content, style, markup problems. |
Date: |
Mon, 25 Oct 2021 03:32:36 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 7b115963632ce1ba7de31fdba9682e7583e27d75
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Oct 23 12:34:02 2021 +1100
glilypond(1): Fix content, style, markup problems.
* Tighten wording and use idiomatic English. The page needs much more
of these activities.
* Drop garbage content that I suspect to be a relic of Bernd's abortive
'FONT' man(7) macro initiative[1].
[1] https://lists.gnu.org/archive/html/groff/2014-01/msg00048.html
---
contrib/glilypond/glilypond.1.man | 81 +++++++++++++--------------------------
1 file changed, 27 insertions(+), 54 deletions(-)
diff --git a/contrib/glilypond/glilypond.1.man
b/contrib/glilypond/glilypond.1.man
index ed3c22e..e671a41 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -92,21 +92,15 @@ glilypond \- embed LilyPond musical notation in groff
documents
.\" ====================================================================
.
.I glilypond
-transforms sheet music written in the
-.I lilypond
-language into the
+is a
.MR groff @MAN7EXT@
-language using the
-.B .PSPIC
-request, such that
-.MR groff @MAN1EXT@
-can transform it into a format that can be displayed directly.
-.
-.B .PDFPIC
-is available, but does on yet work with lilypond.
-.
+preprocessor that enables the embedding of LilyPond music scores in
+.I groff
+documents.
+.\".
+.\".B .PDFPIC
+.\"is available, but does not yet work with lilypond.
.
-.P
If no operands are given,
or if
.I file
@@ -127,42 +121,27 @@ even if their names start with a dash.
.SH Usage
.\" ====================================================================
.
-Together with
-.BR .PSPIC ,
-.I glilypond can work only for
-.I troff
-devices without
-.I PDF
-and
-.I X
-devices.
-.
-.
-.P
-I.e., the following
+At present,
+.I glilypond
+works with the
.I groff
-devices work,
-.BR \-Tps ,
-.BR \-Tdvi ,
-.BR \-Thtml ,
+.BR ps ,
+.BR dvi ,
+.BR html ,
and
-.BR \-Txhtml .
-.
+.B xhtml
+devices.
.
-.P
-I'm not sure about the
+The
.B lbp
and
.B lj4
-devices.
-.
+devices are untested.
.
-.P
-Unfortunately, the
-.I groff
-option
-.B \-Tpdf
-does not work.
+Unfortunately,
+the
+.B pdf
+device does not yet work.
.
.
.\" ====================================================================
@@ -189,11 +168,9 @@ Display copyright license information and exit.
.
.TP
.B \-\-ly2eps
-Here the
-.I lilypond
-program creates
-.I eps
-files directly.
+Direct
+.MR lilypond 1
+to create Encapsulated PostScript (EPS) files.
.
This is the default.
.
@@ -202,17 +179,13 @@ This is the default.
.B \-\-pdf2eps
The program
.I glilypond
-generates a
-.I PDF
-file using
+generates a PDF file using
.IR lilypond .
.
-Then the
-.I eps
-file is generated by
+Then the EPS file is generated by
.I pdf2ps
and
-.IR ps2eps R .
+.IR ps2eps .
.
.
.\" ====================================================================
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 13/35: glilypond(1): Fix content, style, markup problems.,
G. Branden Robinson <=