• R/O
  • SSH

提交

標籤
無標籤

Frequently used words (click to add to your profile)

javac++androidlinuxc#objective-cqt誰得cocoawindowspythonrubyphpgameguibathyscaphec翻訳omegat計画中(planning stage)frameworktwittertestdombtronvb.netdirectxarduinopreviewerゲームエンジン

Reference Documentation: PDF Publishing with GNU Troff


Commit MetaInfo

修訂852dc6c1c5eb2e7adf5507cd0498225f1ef2d2ee (tree)
時間2022-03-30 21:05:29
作者Keith Marshall <keith@user...>
CommiterKeith Marshall

Log Message

Avoid keeps for widow and orphan line control.

* pdfmark.ms (KS, KE): Avoid using these for widow and orphan line
control; in particular do not include any section heading within such
a construct, as it may result in incorrect page numbering within the
generated table of contents; instead, use "ne" requests, with...
(\n[PD]u): ...this form for paragraph distance references used
consistently, in preference to...
(\n(PDu): ...this.

Change Summary

差異

diff -r a01868c021e5 -r 852dc6c1c5eb pdfmark.ms
--- a/pdfmark.ms Tue Mar 29 20:12:08 2022 +0100
+++ b/pdfmark.ms Wed Mar 30 13:05:29 2022 +0100
@@ -510,7 +510,7 @@
510510 to help identify appropriate markup examples for implementing PDF features,
511511 such as:\(en
512512 .QS
513-.sp -\n(PDu
513+.sp -\n[PD]u
514514 .IP \(bu
515515 Selecting a default document view, which defines how the document will appear
516516 when opened in the reader application; for example, when this document is
@@ -535,7 +535,7 @@
535535 Adding annotations, in the form of \(lqsticky notes\(rq, at strategic
536536 points within the PDF document.
537537 .QE
538-.sp -\n(PDu
538+.sp -\n[PD]u
539539 .LP
540540 All of the techniques described have been tested on
541541 .EM both
@@ -1116,7 +1116,7 @@
11161116 .CW PDFHREF.VIEW.LEADING ,
11171117 which determine the effective view specification as follows:\(en
11181118 .QS
1119-.sp -\n(PDu
1119+.sp -\n[PD]u
11201120 .IP \*[= PDFBOOKMARK.VIEW]
11211121 Establishes the magnification at which the document will be viewed,
11221122 at the location of the \(lqbookmark\(rq; by default, it is defined by
@@ -1260,7 +1260,7 @@
12601260 'ne 5
12611261 For example, the setting used in this document:
12621262 .QS
1263-.sp -\n(PDu
1263+.sp -\n[PD]u
12641264 .LD
12651265 .fam C
12661266 \&.\e" Initialize the outline view to show only three heading levels,
@@ -1268,9 +1268,9 @@
12681268 \&.\e"
12691269 \&.nr PDFOUTLINE.FOLDLEVEL 3
12701270 .DE
1271-.sp -\n(PDu
1271+.sp -\n[PD]u
12721272 .QE
1273-.sp -\n(PDu
1273+.sp -\n[PD]u
12741274 .LP
12751275 results in only the first three levels of headings being displayed
12761276 in the document outline,
@@ -1463,7 +1463,7 @@
14631463 which defines the specific reference operation to be performed,
14641464 and may be selected from:\(en
14651465 .QS
1466-.sp -\n(PDu
1466+.sp -\n[PD]u
14671467 .IP \*[= O]
14681468 Add an entry to the document outline.
14691469 This operation has been described earlier,
@@ -1599,7 +1599,7 @@
15991599 .CW pdfhref
16001600 macro, are:\(en
16011601 .QS
1602-.sp -\n(PDu
1602+.sp -\n[PD]u
16031603 .IP \*[= -N\0 name > <]
16041604 Allows the
16051605 .CWI name > <
@@ -1690,9 +1690,9 @@
16901690 .EM without
16911691 this option, the link destination is assumed to be defined
16921692 within the same document.
1693-.KS
1694-.sp -\n(PDu
1693+.
16951694 .IP \*[= -P\0 \(dqprefix\(hytext\(dq > <]
1695+'ne 4v
16961696 Specifies
16971697 .CWI \(dqprefix\(hytext\(dq > \%<
16981698 to be attached to the
@@ -1706,10 +1706,9 @@
17061706 .CWB W \& \& \(rq \(lq
17071707 .CW pdfhref
17081708 operators.
1709-.KE
1710-.KS
1711-.sp -\n(PDu
1709+.
17121710 .IP
1711+'ne 3v
17131712 Typically, this option would be used to insert punctuation before
17141713 the link \%\(lqhot\(hyspot\(rq.
17151714 Thus, there is little reason for the inclusion of spaces in
@@ -1717,10 +1716,9 @@
17171716 however, if such space is required, then the enclosing double quotes
17181717 .EM must
17191718 be specified, as indicated.
1720-.KE
1721-.KS
1722-.sp -\n(PDu
1719+.
17231720 .IP \*[= -A\0 \(dqaffixed\(hytext\(dq > <]
1721+'ne 4v
17241722 Specifies
17251723 .CWI \(dqaffixed\(hytext\(dq > \%<
17261724 to be attached to the
@@ -1734,10 +1732,9 @@
17341732 .CWB W \& \& \(rq \(lq
17351733 .CW pdfhref
17361734 operators.
1737-.KE
1738-.KS
1739-.sp -\n(PDu
1735+.
17401736 .IP
1737+'ne 3v
17411738 Typically, this option would be used to insert punctuation after
17421739 the link \%\(lqhot\(hyspot\(rq.
17431740 Thus, there is little reason for the inclusion of spaces in
@@ -1745,7 +1742,7 @@
17451742 however, if such space is required, then the enclosing double quotes
17461743 .EM must
17471744 be specified, as indicated.
1748-.KE
1745+.
17491746 .IP \*[= -T\0 tag > <]
17501747 When specified with the
17511748 .CWB O \& \& \(rq \(lq
@@ -1820,7 +1817,7 @@
18201817 if only for the entirely cosmetic benefit of visually separating
18211818 the main argument list from the sequence of preceding options.
18221819 .QE
1823-.sp -\n(PDu
1820+.sp -\n[PD]u
18241821 .LP
18251822 In addition to the
18261823 .CW pdfhref
@@ -1841,7 +1838,7 @@
18411838 .CWBI file > <
18421839 option is not specified, are:\(en
18431840 .QS
1844-.sp -\n(PDu
1841+.sp -\n[PD]u
18451842 .IP \*[= -DF\0 dos\(hyfile > <]
18461843 Specifies the name of the file in which a link destination is defined,
18471844 using the file naming semantics of the
@@ -2063,8 +2060,8 @@
20632060 or to modify the default format for cross reference links,
20642061 .XR set-format ). (
20652062 .
2066-.KS
20672063 .NH 4
2064+'ne 4v+\n[PD]u
20682065 .XN -N pdfhref-view -- Associating a Document View with a Reference Mark
20692066 .LP
20702067 In the same manner as each document outline reference, defined by the
@@ -2079,7 +2076,6 @@
20792076 with the
20802077 .CWB M \& \& \(rq \(lq
20812078 operator, requires an associated document view specification.
2082-.KE
20832079 .LP
20842080 The mechanism whereby a document view is associated with a reference mark
20852081 is entirely analogous to that employed for outline references,
@@ -2092,7 +2088,7 @@
20922088 'ne 2v
20932089 Thus, the reference view is defined in terms of:\(en
20942090 .QS
2095-.sp -\n(PDu
2091+.sp -\n[PD]u
20962092 .IP \*[= PDFHREF.VIEW]
20972093 A string,
20982094 establishing the position of the reference mark within the viewing window,
@@ -2128,7 +2124,7 @@
21282124 when the reference is selected.
21292125 .QE
21302126 .LP
2131-.sp -\n(PDu
2127+.sp -\n[PD]u
21322128 Just as the view associated with outline references may be changed,
21332129 by redefining
21342130 .CW PDFBOOKMARK.VIEW ,
@@ -2479,7 +2475,7 @@
24792475 and sometimes also referred to as a Uniform Resource Locator,
24802476 or \(lqURL\(rq).
24812477 .LP
2482-'ne 7v+(u;2*\n(PD)
2478+'ne 7v+(u;2*\n[PD])
24832479 Since the mechanism for creating a link to a URI differs somewhat
24842480 from that for creating PDF references, the
24852481 .CW pdfhref
@@ -2640,7 +2636,7 @@
26402636 by default;
26412637 it is controlled by a pair of strings:\(en
26422638 .QS
2643-.sp -\n(PDu
2639+.sp -\n[PD]u
26442640 .IP \*[= PDFHREF.BORDER]
26452641 This string comprises a \%space\(hyseparated triplet of numeric values,
26462642 optionally followed by a further \%space\(hyseparated
@@ -2668,10 +2664,10 @@
26682664 thus appearing to disable the use of borders
26692665 for link visualization.
26702666 This differs from the \*[Adobe] default,
2667+'ne 4v+(u;2*\n[PD])
26712668 which represents a solid (visible) line,
26722669 one pixel in width,
26732670 and with rectangular corners;
2674-'ne 3v+(u;2*\n(PD)
26752671 this \*[Adobe] default may be reinstated,
26762672 by explicitly defining
26772673 .RS
@@ -2767,7 +2763,7 @@
27672763 is established by a further string assignment,
27682764 viz.:\(en
27692765 .QS
2770-.sp -\n(PDu
2766+.sp -\n[PD]u
27712767 .IP \*[= PDFHREF.TEXT.COLOUR]
27722768 Specifies the text colour,
27732769 for rendition of PDF reference links.
@@ -2852,7 +2848,7 @@
28522848 .pdfhref L -D set-colour -P \(lq -A \(rq -- use of colour
28532849 reference,
28542850 in the initial paragraph of
2855-'ne 3u*\n[PD]u+4v
2851+'ne 4v+(u;3*\n[PD])
28562852 .pdfhref L -D user-format -A , -- this section
28572853 points to a destination named by mark up similar to:\(en
28582854 .QP
@@ -2864,8 +2860,8 @@
28642860 .QP
28652861 .CW ".pdfhref L -D set-colour -- use of colour"
28662862 .
2867-.KS
28682863 .NH 4
2864+'ne 3v+(u;2*\n[PD])
28692865 .XN -N auto-format -- Using Automatically Formatted Reference Text
28702866 .LP
28712867 When the text within a link \%\(lqhot\(hyspot\(rq is specified explicitly,
@@ -2879,8 +2875,7 @@
28792875 --
28802876 .CWI explicit-text > <
28812877 .fam
2882-'ne 2v+\n(PDu
2883-.KE
2878+'ne 2v+\n[PD]u
28842879 .LP
28852880 as described in
28862881 .pdfhref L -D user-format -A , -- the preceding section
@@ -3061,8 +3056,8 @@
30613056 as explained in
30623057 .pdfhref L -D custom-format -A . -- the following section
30633058 .
3064-.KS
30653059 .NH 4
3060+'ne 5v+(u;3*\n[PD])
30663061 .XN -N custom-format -- Customizing Automatically Formatted Reference Text
30673062 .LP
30683063 \(lqAutomatically formatted\(rq reference text is interpolated,
@@ -3077,7 +3072,7 @@
30773072 option,
30783073 .EM "and either" \^:\(en
30793074 .QS
3080-.sp -\n(PDu
3075+.sp -\n[PD]u
30813076 .IP \(bu
30823077 no explicit reference text is specified,
30833078 (in which case,
@@ -3091,7 +3086,7 @@
30913086 option is specified,
30923087 in conjunction with explicit reference text.
30933088 .QE
3094-.KE
3089+.sp -\n[PD]u
30953090 .LP
30963091 In each of these cases,
30973092 the reference text is derived,
@@ -3190,7 +3185,7 @@
31903185 default formatting macro is used,
31913186 formatting progresses as follows:\(en
31923187 .QS
3193-.sp -\n(PDu
3188+.sp -\n[PD]u
31943189 .nr ITEM 0 1
31953190 .de ITEMIZE ITEMIZE
31963191 .IP \s'-2.5p'\\n+[ITEM]\s'+2.5p'.
@@ -3293,6 +3288,7 @@
32933288 and which defines the extent of,
32943289 the link \%\(lqhot\(hyspot\(rq region.
32953290 .QE
3291+.sp -\n[PD]u
32963292 .LP
32973293 From the foregoing,
32983294 it may be deduced that reference text,
@@ -3316,7 +3312,7 @@
33163312 Within the formatted text,
33173313 the keyword/value pair interpolations appear
33183314 in the order in which \(lqknown\(rq keywords are found,
3319-'ne 7v+\n(PDu
3315+'ne 7v+\n[PD]u
33203316 while parsing the
33213317 .CW PDFHREF.INFO
33223318 record;
@@ -3724,7 +3720,7 @@
37243720 the user should:\(en
37253721 .QS
37263722 .nr ITEM 0 1
3727-.sp -\n(PDu
3723+.sp -\n[PD]u
37283724 .ITEMIZE
37293725 Define a page transition macro, to provide whatever features may be required,
37303726 when a page transition occurs \(em e.g.\& printing footnotes,
@@ -3732,11 +3728,13 @@
37323728 This macro should end by setting the output position at the correct
37333729 vertical page offset, where the printing of running text is to restart,
37343730 following the page transition.
3731+.
37353732 .ITEMIZE
37363733 Plant a trap to invoke this macro, at the appropriate vertical position
37373734 marking the end of normal running text on each page.
3738-.KS
3735+.
37393736 .ITEMIZE
3737+'ne 4v+(u;2*\n[PD])
37403738 Initialize the
37413739 .CW pdfhref
37423740 hook into this page transition trap, by invoking
@@ -3753,7 +3751,6 @@
37533751 .CW pdfhref
37543752 will correctly restart mapping of active link regions,
37553753 at the start of each new page.
3756-.KE
37573754 .RE
37583755 .QE
37593756 .LP
@@ -3829,7 +3826,7 @@
38293826 .CW groff
38303827 formatting process is allowed to complete.
38313828 .LP
3832-'ne 4v+\n(PDu
3829+'ne 4v+\n[PD]u
38333830 To allow the user to choose when cached
38343831 .CW pdfmark
38353832 data is to be flushed to the output stream, the
@@ -4116,7 +4113,7 @@
41164113 .CW spdf.tmac
41174114 provides:\(en
41184115 .QS
4119-.sp -\n(PDu
4116+.sp -\n[PD]u
41204117 .IP \(bu
41214118 Macros to isolate the
41224119 .EM \%front\(hymatter ,
@@ -4264,7 +4261,7 @@
42644261 .CW spdf.tmac
42654262 macros is specified as:\(en
42664263 .DS I
4267-.sp -\n(PDu
4264+.sp -\n[PD]u
42684265 .CWB .SH
42694266 .CWB .XH \& \& \0\c
42704267 .CWB -N \& [ \ \c
@@ -4276,7 +4273,7 @@
42764273 .CW ...
42774274 .DE
42784275 .DS I
4279-.sp -\n(PDu
4276+.sp -\n[PD]u
42804277 .CWB .NH \& \& \0\c
42814278 .CWI outline-level > <
42824279 .CWB .XN \& \& \0\c
@@ -4288,7 +4285,7 @@
42884285 .CW ...
42894286 .DE
42904287 .LP
4291-.sp -\n(PDu
4288+.sp -\n[PD]u
42924289 In either case,
42934290 the
42944291 .CWI heading-text >... < \&
@@ -4345,7 +4342,7 @@
43454342 .FE
43464343 are:\(en
43474344 .QS
4348-.sp -\n(PDu
4345+.sp -\n[PD]u
43494346 .IP "\f(CB-N\fP \FC<\fIname\fP>\F[]"
43504347 Create a
43514348 .CW pdfhref