提交: 87af6703595c8cc9caea9cfe91081fdc2bb98a21 - groff-pdfmark (hg)

Reference Documentation: PDF Publishing with GNU Troff

Commit MetaInfo

• 修訂: 87af6703595c8cc9caea9cfe91081fdc2bb98a21 (tree)
• 時間: 2021-11-18 23:39:54
• 作者: Keith Marshall <keith@user...>
• Commiter: Keith Marshall

Log Message

Avoid unwanted line-breaks at hard hyphenation points.

* pdfmark.ms: Ensure that all explicitly hyphenated words are prefixed
by "\%", to make hard hyphens non-breaking.

Change Summary

• modified: pdfmark.ms

差異

diff -r 787b45ec7250 -r 87af6703595c pdfmark.ms
--- a/pdfmark.ms	Thu Nov 18 11:16:12 2021 +0000
+++ b/pdfmark.ms	Thu Nov 18 14:39:54 2021 +0000
@@ -399,7 +399,7 @@
 in the document view pane, while a document outline should appear to the left,
 in the \(lqBookmarks\(rq pane.
 .IP \(bu
-Adding document identification \(lqmeta\(hydata\(rq,
+Adding document identification \%\(lqmeta\(hydata\(rq,
 which can be accessed, in \*[Acrobat]\~Reader,
 by inspecting the \(lqFile\^/\^Document\~Properties\^/\^Summary\(rq.
 .IP \(bu
@@ -695,14 +695,14 @@
 .pdfmark-manual
 for more information.
 .LP
-It should be noted that the view controlling meta\(hydata, defined by the
+It should be noted that the view controlling \%meta\(hydata, defined by the
 .CW pdfview
 macro, is not written immediately to the \*[PostScript] output stream,
-but is stored in an internal meta\(hydata \(lqcache\(rq,
+but is stored in an internal \%meta\(hydata \(lqcache\(rq,
 (simply implemented as a
 .CW groff
 diversion).
-This \(lqcached\(lq meta\(hydata must be written out later, by invoking the
+This \(lqcached\(lq \%meta\(hydata must be written out later, by invoking the
 .CW pdfsync
 macro,
 .\"
@@ -719,9 +719,9 @@
 .LP
 In addition to the
 .CW /DOCVIEW
-class of meta\(hydata described above,
+class of \%meta\(hydata described above,
 .XR docview ), (
-we may also wish to include document identification meta\(hydata,
+we may also wish to include document identification \%meta\(hydata,
 which belongs to the PDF
 .CW /DOCINFO
 class.
@@ -730,7 +730,7 @@
 .CW pdfinfo
 macro.
 As an example of how it is used,
-the identification meta\(hydata attached to this document
+the identification \%meta\(hydata attached to this document
 was specified using a macro sequence similar to:\(en
 .DS I
 .CW
@@ -761,7 +761,7 @@
 records specified with the
 .CW pdfinfo
 macro are not immediately written to the \*[PostScript] output stream;
-they are stored in the same meta\(hydata cache as
+they are stored in the same \%meta\(hydata cache as
 .CW /DOCVIEW
 specifications, until this cache is explicitly flushed,
 by invoking the
@@ -1388,9 +1388,9 @@
 .XR set-format ). (
 .IP \*[= Z]
 Define the absolute position on the physical PDF output page,
-where the \(lqhot\(hyspot\(rq associated with an active link is to be placed.
-Invoked in pairs, marking the starting and ending PDF page co\(hyordinates
-for each link \(lqhot\(hyspot\(rq, this operator is rarely, if ever,
+where the \%\(lqhot\(hyspot\(rq associated with an active link is to be placed.
+Invoked in pairs, marking the starting and ending PDF page \%co\(hyordinates
+for each link \%\(lqhot\(hyspot\(rq, this operator is rarely, if ever,
 specified directly by the user;
 rather, appropriate
 .CW pdfhref
@@ -1406,7 +1406,7 @@
 .CW pdfhref
 implementation provides only one such feature which requires initialization
 \(em a helper macro which must be attached to a user supplied page trap handler,
-in order to support mapping of reference \(lqhot\(hyspots\(rq
+in order to support mapping of reference \%\(lqhot\(hyspots\(rq
 which extend through a page transition;
 .XR page-trap ). (
 .QE
@@ -1513,7 +1513,7 @@
 .CW URI ,
 or the destination name associated with a PDF active link,
 independently of the following text,
-which describes the link and demarcates the link \(lqhot\(hyspot\(rq.
+which describes the link and demarcates the link \%\(lqhot\(hyspot\(rq.
 This option affects the behaviour of the
 .CW pdfhref
 macro's
@@ -1565,12 +1565,12 @@
 .sp -\n(PDu
 .IP \*[= -P\0 \(dqprefix\(hytext\(dq > <]
 Specifies
-.CWI \(dqprefix\(hytext\(dq > <
+.CWI \(dqprefix\(hytext\(dq > \%<
 to be attached to the
 .EM start
 of the text describing an active PDF document link,
 with no intervening space, but without itself being included in the
-active area of the link \(lqhot\(hyspot\(rq;
+active area of the link \%\(lqhot\(hyspot\(rq;
 it is effective with the
 .CWB L \& \& \(rq \(lq
 and
@@ -1582,9 +1582,9 @@
 .sp -\n(PDu
 .IP
 Typically, this option would be used to insert punctuation before
-the link \(lqhot\(hyspot\(rq.
+the link \%\(lqhot\(hyspot\(rq.
 Thus, there is little reason for the inclusion of spaces in
-.CWI \(dqprefix\(hytext\(dq > < ;
+.CWI \(dqprefix\(hytext\(dq > \%< ;
 however, if such space is required, then the enclosing double quotes
 .EM must
 be specified, as indicated.
@@ -1593,12 +1593,12 @@
 .sp -\n(PDu
 .IP \*[= -A\0 \(dqaffixed\(hytext\(dq > <]
 Specifies
-.CWI \(dqaffixed\(hytext\(dq > <
+.CWI \(dqaffixed\(hytext\(dq > \%<
 to be attached to the
 .EM end
 of the text describing an active PDF document link,
 with no intervening space, but without itself being included in the
-active area of the link \(lqhot\(hyspot\(rq;
+active area of the link \%\(lqhot\(hyspot\(rq;
 it is effective with the
 .CWB L \& \& \(rq \(lq
 and
@@ -1610,9 +1610,9 @@
 .sp -\n(PDu
 .IP
 Typically, this option would be used to insert punctuation after
-the link \(lqhot\(hyspot\(rq.
+the link \%\(lqhot\(hyspot\(rq.
 Thus, there is little reason for the inclusion of spaces in
-.CWI \(dqaffixed\(hytext\(dq > < ;
+.CWI \(dqaffixed\(hytext\(dq > \%< ;
 however, if such space is required, then the enclosing double quotes
 .EM must
 be specified, as indicated.
@@ -1716,13 +1716,13 @@
 .IP \*[= -DF\0 dos\(hyfile > <]
 Specifies the name of the file in which a link destination is defined,
 using the file naming semantics of the
-.CW MS\(hyDOS \*(rg
+.CW \%MS\(hyDOS \*(rg
 operating system.
 When the PDF document is read on a machine
 where the operating system uses the
-.CW MS\(hyDOS \*(rg
+.CW \%MS\(hyDOS \*(rg
 file system, then
-.CWI dos\(hyfile > <
+.CWI dos\(hyfile > \%<
 is used as the name of the file containing the reference destination,
 overriding the
 .CWI file > <
@@ -1739,7 +1739,7 @@
 where the operating system uses the
 .CW Macintosh \*(rg
 file system, then
-.CWI mac\(hyfile > <
+.CWI mac\(hyfile > \%<
 is used as the name of the file containing the reference destination,
 overriding the
 .CWI file > <
@@ -1755,7 +1755,7 @@
 where the operating system uses
 .CW POSIX
 file naming semantics, then
-.CWI unix\(hyfile > <
+.CWI unix\(hyfile > \%<
 is used as the name of the file containing the reference destination,
 overriding the
 .CWI file > <
@@ -1765,13 +1765,13 @@
 .IP \*[= -WF\0 win\(hyfile > <]
 Specifies the name of the file in which a link destination is defined,
 using the file naming semantics of the
-.CW MS\(hyWindows \*(rg
-32\(hybit operating system.
+.CW \%MS\(hyWindows \*(rg
+\%32\(hybit operating system.
 When the PDF document is read on a machine
 where the operating system uses any of the
-.CW MS\(hyWindows \*(rg
+.CW \%MS\(hyWindows \*(rg
 file systems, with long file name support, then
-.CWI win\(hyfile > <
+.CWI win\(hyfile > \%<
 is used as the name of the file containing the reference destination,
 overriding the
 .CWI file > <
@@ -2097,7 +2097,7 @@
 .CWI text
 arguments are specified, then they will be inserted into the
 .CW groff
-output stream, to define the text appearing in the \(lqhot\(hyspot\(rq
+output stream, to define the text appearing in the \%\(lqhot\(hyspot\(rq
 region of the link;
 this will be printed in the link colour specified by the string,
 .CW PDFHREF.TEXT.COLOUR ,
@@ -2118,7 +2118,7 @@
 .EM either
 the
 .CWB -D \& \& \~\c
-.CWBI dest\(hyname > <
+.CWBI dest\(hyname > \%<
 option,
 .EM or
 the
@@ -2129,18 +2129,18 @@
 may be omitted.
 If the
 .CWB -D \& \& \~\c
-.CWBI dest\(hyname > <
+.CWBI dest\(hyname > \%<
 option is omitted, then the first word of
 .CWI descriptive \& \& \~\c
 .CWI text \& \& ,
 i.e.\~all text up to but not including the first space,
 will be interpreted as the
-.CWBI dest\(hyname > <
+.CWBI dest\(hyname > \%<
 for the link; this text will also appear in the running text of the document,
 within the active region of the link.
 Alternatively, if the
 .CWB -D \& \& \~\c
-.CWBI dest\(hyname > <
+.CWBI dest\(hyname > \%<
 option
 .EM is
 specified, and
@@ -2165,10 +2165,10 @@
 .LP
 The
 .CWB -P \& \& \~\c
-.CWBI prefix\(hytext > <
+.CWBI prefix\(hytext > \%<
 and
 .CWB -A \& \& \~\c
-.CWBI affixed\(hytext > <
+.CWBI affixed\(hytext > \%<
 options may be used to specify additional text
 which will be placed before and after the linked text respectively,
 with no intervening space.
@@ -2264,14 +2264,14 @@
 be specified when referring to a destination in an external PDF file,
 the
 .CWB -DF \& \& \~\c
-.CWBI dos\(hyfile > < ,
+.CWBI dos\(hyfile > \%< ,
 .CWB -MF \& \& \~\c
-.CWBI mac\(hyfile > < ,
+.CWBI mac\(hyfile > \%< ,
 .CWB -UF \& \& \~\c
-.CWBI unix\(hyfile > <
+.CWBI unix\(hyfile > \%<
 and
 .CWB -WF \& \& \~\c
-.CWBI win\(hyfile > <
+.CWBI win\(hyfile > \%<
 options may be used to specify the location of the file
 containing the reference destination,
 in a variety of operating system dependent formats.
@@ -2290,22 +2290,22 @@
 .CWBI file > <
 option, and the document is read on the appropriate operating systems,
 then the path names specified by
-.CWBI dos\(hyfile > < ,
-.CWBI mac\(hyfile > < ,
-.CWBI unix\(hyfile > <
+.CWBI dos\(hyfile > \%< ,
+.CWBI mac\(hyfile > \%< ,
+.CWBI unix\(hyfile > \%<
 and
-.CWBI win\(hyfile > <
+.CWBI win\(hyfile > \%<
 will be searched,
 .EM instead
 of the path name specified by
 .CWBI file > < ,
 for each of the
-.CW MS\(hyDOS \*(rg,
+.CW \%MS\(hyDOS \*(rg,
 .CW Apple \*(rg
 .CW Macintosh \*(rg,
 .CW Unix \(tm
 and
-.CW MS\(hyWindows \*(rg
+.CW \%MS\(hyWindows \*(rg
 operating systems, respectively; see the
 .pdfmark-manual ,
 for further details.
@@ -2356,7 +2356,7 @@
 .CW pdfhref
 macro is invoked with the
 .CWB W \& \& \(rq \(lq
-(for \(lqweb\(hylink\(rq) operator, rather than the
+(for \%\(lqweb\(hylink\(rq) operator, rather than the
 .CWB L \& \& \(rq \(lq
 operator; nevertheless, the invocation syntax is similar, having the form
 .QP
@@ -2384,13 +2384,13 @@
 format, while the
 .CWI descriptive
 .CWI text
-argument specifies the text which is to appear in the \(lqhot\(hyspot\(rq
+argument specifies the text which is to appear in the \%\(lqhot\(hyspot\(rq
 region, and the
 .CWB -P
-.CWBI prefix\(hytext > <
+.CWBI prefix\(hytext > \%<
 and
 .CWB -A
-.CWBI affixed\(hytext > <
+.CWBI affixed\(hytext > \%<
 options have the same effect as in the case of local document links,
 .XR link-intern ). (
 .LP
@@ -2404,7 +2404,7 @@
 .CWI descriptive
 .CWI text
 argument exactly defines the text
-which will appear within the \(lqhot\(hyspot\(rq region,
+which will appear within the \%\(lqhot\(hyspot\(rq region,
 and this need not include the URI.
 However, if the
 .CWB -D \& \& \~\c
@@ -2418,7 +2418,7 @@
 .EM exact
 representation of the URI, which
 .EM will ,
-therefore, appear as the entire content of the \(lqhot\(hyspot\(rq.
+therefore, appear as the entire content of the \%\(lqhot\(hyspot\(rq.
 For example, we could introduce a reference to
 .pdfhref W -D \*[GROFF-WEBSITE] -A , the groff web site
 in which the actual URI is concealed, by using mark up such as:\(en
@@ -2512,16 +2512,16 @@
 .XN -N page-trap -- Links with a Page Transition in the Active Region
 .LP
 When a link is placed near the bottom of a page,
-it is possible that its active region, or \(lqhot\(hyspot\(rq,
+it is possible that its active region, or \%\(lqhot\(hyspot\(rq,
 may extend on to the next page.
 In this situation, a page trap macro is required
 to intercept the page transition, and to restart the mapping of
-the \(lqhot\(hyspot\(rq boundary on the new page.
+the \%\(lqhot\(hyspot\(rq boundary on the new page.
 .LP
 The
 .CW pdfmark
 macro package includes a suitable page trap macro, to satisfy this requirement.
-However, to avoid pre\(hyempting any other requirement the user may have for
+However, to avoid \%pre\(hyempting any other requirement the user may have for
 a page transition trap, this is
 .EM not
 installed as an active page trap,
@@ -2626,7 +2626,7 @@
 .CW pdfview
 and
 .CW pdfinfo
-\(lqmeta\(hydata\(rq,
+\%\(lqmeta\(hydata\(rq,
 this \(lqmore appropriate time\(rq is explicitly chosen by the user;
 in the case of document outline data,
 .EM some
@@ -2652,7 +2652,7 @@
 .LP
 This form of invocation ensures that
 .EM both
-the \(lqmeta\(hydata cache\(rq, containing
+the \%\(lqmeta\(hydata cache\(rq, containing
 .CW pdfview
 and
 .CW pdfinfo
@@ -2669,8 +2669,8 @@
 terminates.
 .LP
 Occasionally,
-it may be desirable to flush either the \(lqmeta\(hydata cache\(rq,
-without affecting the \(lqoutline cache\(rq, or vice\(hyversa,
+it may be desirable to flush either the \%\(lqmeta\(hydata cache\(rq,
+without affecting the \(lqoutline cache\(rq, or \%vice\(hyversa,
 at a user specified time, prior to reaching the end of the document.
 This may be accomplished, by invoking the
 .CW pdfsync
@@ -2679,14 +2679,14 @@
 .fam C
 .B ".pdfsync M"
 .LP
-to flush only the \(lqmeta\(hydata cache\(rq, or
+to flush only the \%\(lqmeta\(hydata cache\(rq, or
 .QP
 .fam C
 .B ".pdfsync O"
 .LP
 to flush only the \(lqoutline cache\(rq.
 .LP
-The \(lqmeta\(hydata cache\(rq can normally be safely flushed
+The \%\(lqmeta\(hydata cache\(rq can normally be safely flushed
 in this manner, at any time
 .EM after
 output of the first page has started;