sync,doc

git-svn-id: svn://tug.org/texlive/trunk@43842 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 276 insertions, 10 deletions

diff --git a/Master/texmf-dist/bibtex/bib/beebe/typeset.bib b/Master/texmf-dist/bibtex/bib/beebe/typeset.bib
index 000771a0824..2f570bcf3e2 100644
--- a/Master/texmf-dist/bibtex/bib/beebe/typeset.bib
+++ b/Master/texmf-dist/bibtex/bib/beebe/typeset.bib
@@ -2,9 +2,9 @@
 %%% ====================================================================
 %%%  BibTeX-file{
 %%%     author          = "Nelson H. F. Beebe",
-%%%     version         = "2.40",
-%%%     date            = "25 March 2017",
-%%%     time            = "14:33:04 MST",
+%%%     version         = "2.41",
+%%%     date            = "13 April 2017",
+%%%     time            = "17:16:13 MST",
 %%%     filename        = "typeset.bib",
 %%%     address         = "University of Utah
 %%%                        Department of Mathematics, 110 LCB
@@ -14,7 +14,7 @@
 %%%     telephone       = "+1 801 581 5254",
 %%%     FAX             = "+1 801 581 4148",
 %%%     URL             = "http://www.math.utah.edu/~beebe",
-%%%     checksum        = "23612 22456 105660 998354",
+%%%     checksum        = "31906 22719 107203 1010745",
 %%%     email           = "beebe at math.utah.edu, beebe at acm.org,
 %%%                        beebe at computer.org (Internet)",
 %%%     codetable       = "ISO/ASCII",
@@ -39,7 +39,7 @@
 %%%                        and PDF (Portable Document Format), and
 %%%                        sgml.bib covers SGML and HTML.
 %%%
-%%%                        At version 2.40, the year coverage looked
+%%%                        At version 2.41, the year coverage looked
 %%%                        like this:
 %%%
 %%%                             1881 (   1)    1927 (   0)    1973 (  10)
@@ -56,7 +56,7 @@
 %%%                             1892 (   0)    1938 (   0)    1984 (  40)
 %%%                             1893 (   0)    1939 (   1)    1985 (  33)
 %%%                             1894 (   0)    1940 (   1)    1986 (  59)
-%%%                             1895 (   0)    1941 (   1)    1987 (  54)
+%%%                             1895 (   0)    1941 (   1)    1987 (  55)
 %%%                             1896 (   0)    1942 (   0)    1988 (  40)
 %%%                             1897 (   0)    1943 (   0)    1989 (  30)
 %%%                             1898 (   1)    1944 (   0)    1990 (  33)
@@ -92,7 +92,7 @@
 %%%                             20xx (   2)
 %%%
 %%%                             Article:        320
-%%%                             Book:           301
+%%%                             Book:           302
 %%%                             InCollection:     5
 %%%                             InProceedings:   54
 %%%                             Manual:          42
@@ -103,7 +103,7 @@
 %%%                             Proceedings:     33
 %%%                             TechReport:      31
 %%%
-%%%                             Total entries:  836
+%%%                             Total entries:  837
 %%%
 %%%                        This bibliography has been collected from
 %%%                        bibliographies in the author's personal
@@ -507,6 +507,10 @@
 @String{pub-HARVARD-INFO-TECH:adr = "Cambridge, MA, USA"}
 @String{pub-HARVARD:adr         = "Cambridge, MA, USA"}
 
+@String{pub-HAYDEN              = "Hayden Books"}
+@String{pub-HAYDEN:adr          = "4300 West 62nd Street, Indianapolis, IN
+                                    46268, USA"}
+
 @String{pub-HYPHEN              = "Hyphen Press"}
 @String{pub-HYPHEN:adr          = "London, UK"}
 
@@ -10894,6 +10898,265 @@
                  Miscellaneous",
 }
 
+@Book{Dougherty:1987:UTP,
+  editor =       "Dale Dougherty and Tim O'Reilly",
+  title =        "{UNIX} Text Processing",
+  publisher =    pub-HAYDEN,
+  address =      pub-HAYDEN:adr,
+  pages =        "xiv + 665",
+  year =         "1987",
+  ISBN =         "0-672-46291-5 (paperback)",
+  ISBN-13 =      "978-0-672-46291-7 (paperback)",
+  LCCN =         "Z286.D47 D68 1987",
+  bibdate =      "Thu Apr 13 17:06:28 MDT 2017",
+  bibsource =    "http://www.math.utah.edu/pub/tex/bib/typeset.bib;
+                 http://www.math.utah.edu/pub/tex/bib/unix.bib;
+                 z3950.loc.gov:7090/Voyager",
+  price =        "US\$26.95",
+  series =       "Hayden Books UNIX library system",
+  URL =          "ftp://ftp.ffii.org/pub/groff/contrib/documentation/utp/;
+                 http://books.google.com/books?id=H148AQAAIAAJ;
+                 http://catalog.hathitrust.org/api/volumes/oclc/15722288.html;
+                 http://proquest.safaribooksonline.com/?fpi=9780810462915;
+                 http://www.oreilly.com/openbook/utp/UnixTextProcessing.pdf
+                 http://proquest.tech.safaribooksonline.de/9780810462915",
+  acknowledgement = ack-nhfb,
+  keywords =     "awk; eqn; ex; format; make; mm; ms; pic; sed; tbl;
+                 troff; vi",
+  remark =       "Consulting editors: Stephen G. Kochan and Patrick H.
+                 Wood.",
+  subject =      "Desktop publishing; UNIX (Computer file)",
+  tableofcontents = "1 From Typewriters to Word Processors / 1 \\
+                 A Workspace / 2 \\
+                 Tools for Editing / 3 \\
+                 Document Formatting / 4 \\
+                 Printing / 6 \\
+                 Other UNIX Text-Processing Tools / 7 \\
+                 2 UNIX Fundamentals / 9 \\
+                 The UNIX Shell / 9 \\
+                 Output Redirection / 10 \\
+                 Special Characters / 14 \\
+                 Environment Variables / 15 \\
+                 Pipes and Filters / 16 \\
+                 Shell Scripts / 17 \\
+                 3 Learning vi / 19 \\
+                 Session 1: Basic Commands / 19 \\
+                 Opening a File / 20 \\
+                 Moving the Cursor / 22 \\
+                 Simple Edits / 25 \\
+                 Session 2: Moving Around in a Hurry / 32 \\
+                 Movement by Screens / 32 \\
+                 Movement by Text Blocks / 34 \\
+                 Movement by Searches / 35 \\
+                 Movement by Line Numbers / 37 \\
+                 Session 3: Beyond the Basics / 38 \\
+                 Command-Line Options / 38 \\
+                 Customizing vi / 40 \\
+                 Edits and Movement / 42 \\
+                 More Ways to Insert Text / 43 \\
+                 Using Buffers / 43 \\
+                 Marking Your Place / 45 \\
+                 Other Advanced Edits / 46 \\
+                 4 nroff and troff / 47 \\
+                 What the Formatter Does / 48 \\
+                 Using nroff / 51 \\
+                 Using troff / 51 \\
+                 The Markup Language / 54 \\
+                 Turning Filling On and Off / 55 \\
+                 Controlling Justification / 57 \\
+                 Hyphenation / 59 \\
+                 Page Layout / 60 \\
+                 Page Transitions / 70 \\
+                 Changing Fonts / 74 \\
+                 A First Look at Macros / 81 \\
+                 5 The ms Macros / 85 \\
+                 Formatting a Text File with ms / 86 \\
+                 Page Layout / 86 \\
+                 Paragraphs / 87 \\
+                 Changing Font and Point Size / 93 \\
+                 Displays / 97 \\
+                 Headings / 99 \\
+                 Cover Sheet Macros / 100 \\
+                 Miscellaneous Features / 102 \\
+                 Page Headers and Footers / 104 \\
+                 Problems on the First Page / 105 \\
+                 Extensions to ms / 105 \\
+                 6 The mm Macros / 107 \\
+                 Formatting a Text File / 107 \\
+                 Page Layout / 110 \\
+                 Justification / 114 \\
+                 Word Hyphenation / 115 \\
+                 Displays / 115 \\
+                 Changing Font and Point Size / 116 \\
+                 More about Displays / 121 \\
+                 Forcing a Page Break / 125 \\
+                 Formatting Lists / 126 \\
+                 Headings / 136 \\
+                 Table of Contents / 141 \\
+                 Footnotes and References / 142 \\
+                 Extensions to mm / 145 \\
+                 7 Advanced Editing / 149 \\
+                 The ex Editor / 149 \\
+                 Using ex Commands in vi / 151 \\
+                 Write Locally, Edit Globally / 151 \\
+                 Pattern Matching / 154 \\
+                 Writing and Quitting Files / 159 \\
+                 Reading In a File / 160 \\
+                 Executing UNIX Commands / 160 \\
+                 Editing Multiple Files / 163 \\
+                 Word Abbreviation / 165 \\
+                 Saving Commands with map / 166 \\
+                 8 Formatting with tbl / 169 \\
+                 Using tbl / 170 \\
+                 Specifying Tables / 170 \\
+                 A Simple Table Example / 171 \\
+                 Laying Out a Table / 172 \\
+                 Describing Column Formats / 173 \\
+                 Changing the Format within a Table / 181 \\
+                 Putting Text Blocks in a Column / 182 \\
+                 Breaking Up Long Tables / 184 \\
+                 Putting Titles on Tables / 185 \\
+                 A tbl Checklist / 186 \\
+                 Some Complex Tables / 186 \\
+                 9 Typesetting Equations with eqn / 191 \\
+                 A Simple eqn Example / 191 \\
+                 Using eqn / 192 \\
+                 Specifying Equations / 192 \\
+                 Spaces in Equations / 194 \\
+                 Using Braces for Grouping / 196 \\
+                 Special Character Names / 196 \\
+                 Special Symbols / 197 \\
+                 Other Positional Notation / 200 \\
+                 Diacritical Marks / 201 \\
+                 Defining Terms / 202 \\
+                 Quoted Text / 202 \\
+                 Fine-Tuning the Document / 203 \\
+                 Keywords and Precedence / 205 \\
+                 Problem Checklist / 205 \\
+                 10 Drawing Pictures / 207 \\
+                 The pic Preprocessor / 207 \\
+                 From Describing to Programming Drawings / 228 \\
+                 pic Enhancements / 236 \\
+                 11 A Miscellany of UNIX Commands / 239 \\
+                 Managing Your Files / 239 \\
+                 Viewing the Contents of a File / 243 \\
+                 Searching for Information in a File / 244 \\
+                 Proofing Documents / 247 \\
+                 Comparing Versions of the Same Document / 253 \\
+                 Manipulating Data / 260 \\
+                 Cleaning Up and Backing Up / 270 \\
+                 Compressing Files / 272 \\
+                 Communications / 272 \\
+                 Scripts of UNIX Sessions / 274 \\
+                 12 Let the Computer Do the Dirty Work / 275 \\
+                 Shell Programming / 275 \\
+                 ex Scripts / 284 \\
+                 Stream Editing / 288 \\
+                 A Proofreading Tool You Can Build / 303 \\
+                 13 The awk Programming Language / 309 \\
+                 Invoking awk / 310 \\
+                 Records and Fields / 310 \\
+                 Testing Fields / 311 \\
+                 Passing Parameters from a Shell Script / 311 \\
+                 Changing the Field Separator / 312 \\
+                 System Variables / 313 \\
+                 Looping / 313 \\
+                 awk Applications / 319 \\
+                 Testing Programs / 327 \\
+                 14 Writing nroff and troff Macros / 329 \\
+                 Comments / 329 \\
+                 Defining Macros / 330 \\
+                 Macro Names / 330 \\
+                 Macro Arguments / 332 \\
+                 Nested Macro Definitions / 333 \\
+                 Conditional Execution / 334 \\
+                 Interrupted Lines / 337 \\
+                 Number Registers / 338 \\
+                 Defining Strings / 342 \\
+                 Diversions / 343 \\
+                 Environment Switching / 345 \\
+                 Redefining Control and Escape Characters / 346 \\
+                 Debugging Your Macros / 347 \\
+                 Error Handling / 349 \\
+                 Macro Style / 350 \\
+                 15 Figures and Special Effects / 353 \\
+                 Formatter Escape Sequences / 353 \\
+                 Local Vertical Motions / 353 \\
+                 Local Horizontal Motions / 356 \\
+                 Absolute Motions / 357 \\
+                 Line Drawing / 358 \\
+                 Talking Directly to the Printer / 366 \\
+                 Marking a Vertical Position / 367 \\
+                 Overstriking Words or Characters / 368 \\
+                 Tabs, Leaders, and Fields / 372 \\
+                 Constant Spacing / 375 \\
+                 Pseudo-Fonts / 376 \\
+                 Character Output Translations / 377 \\
+                 Output Line Numbering / 378 \\
+                 Change Bars / 379 \\
+                 Form Letters / 380 \\
+                 Reading in Other Files or Program Output / 381 \\
+                 16 What's in a Macro Package? / 383 \\
+                 Just What Is a Macro Package, Revisited / 383 \\
+                 Building a Consistent Framework / 385 \\
+                 Page Transitions / 389 \\
+                 Page Transitions in ms / 390 \\
+                 Some Extensions to the Basic Package / 394 \\
+                 Other Exercises in Page Transition / 397 \\
+                 17 An Extended ms Macro Package / 405 \\
+                 Creating a Custom Macro Package / 405 \\
+                 Structured Technical Documents / 407 \\
+                 Figure and Table Headings / 415 \\
+                 Lists, Lists, and More Lists / 416 \\
+                 Source Code and Other Examples / 419 \\
+                 Notes, Cautions, and Warnings / 420 \\
+                 Table of Contents, Index, and Other End Lists / 422 \\
+                 18 Putting It All Together / 429 \\
+                 Saving an External Table of Contents / 430 \\
+                 Index Processing / 433 \\
+                 Let make Remember the Details / 444 \\
+                 Where to Go from Here / 447 \\
+                 A Editor Command Summary / 449 \\
+                 Pattern-Matching Syntax / 449 \\
+                 The vi Editor / 450 \\
+                 The ex Editor / 455 \\
+                 The sed Editor / 460 \\
+                 awk / 462 \\
+                 B Formatter Command Summary / 467 \\
+                 nroff/troff Command-Line Syntax / 467 \\
+                 nroff/troff Requests / 469 \\
+                 Escape sequences / 472 \\
+                 Predefined Number Registers / 473 \\
+                 Special Characters / 474 \\
+                 The ms macros / 476 \\
+                 The mm Macros / 479 \\
+                 tbl Command Characters and Words / 485 \\
+                 eqn Command Characters / 487 \\
+                 The pic Preprocessor / 490 \\
+                 C Shell Command Summary / 495 \\
+                 D Format of troff Width Tables / 501 \\
+                 The DESC File / 501 \\
+                 Font Description Files / 502 \\
+                 Compiling Font Files / 503 \\
+                 Font Usage Limitations / 503 \\
+                 E Comparing mm and ms / 505 \\
+                 Paragraphs / 505 \\
+                 Justification / 505 \\
+                 Displays / 505 \\
+                 Formatting Lists / 506 \\
+                 Change Font / 506 \\
+                 Change Point Size / 506 \\
+                 Headers and Footers / 506 \\
+                 Section Headings / 506 \\
+                 Footnotes / 507 \\
+                 F The format Macros / 509 \\
+                 Summary of the Macros / 509 \\
+                 G Selected Readings / 511 \\
+                 Introductory UNIX Texts / 511 \\
+                 Advanced Topics / 511 \\
+                 Index / dxiii",
+}
+
 @Book{Emerson:1987:TTU,
   author =       "Sandra L. Emerson and Karen Paulsell",
   title =        "Troff typesetting for {UNIX} systems",
diff --git a/Master/tlpkg/doc/releng.txt b/Master/tlpkg/doc/releng.txt
index 4ecf7bf8123..1808e02c4cd 100644
--- a/Master/tlpkg/doc/releng.txt
+++ b/Master/tlpkg/doc/releng.txt
@@ -83,8 +83,11 @@ for p in *conv hbf2gf; do cp /home/ftp/mirror/rsync.tex.ac.uk/CTAN/language/chin
 This will fail because pretest is not set up, but that's ok; the idea is
 to check the output and ensure all is as basically ok.
 
-9. After first successful pretest build, do
-recreate=--recreate  # just once! to get catalogue updates.
+9. After that trial build, set
+recreate=--recreate  # just once! to get catalogue updates, and again:
+  mkdir /home/ftp/texlive/tlpretest/tlpkg
+  touch !$/texlive.tlpdb
+  force_rebuild=true cron.tl
 
 A. After tlnet freeze:
   Run tl-update-linked-scripts for consistency.