Add files written by Felix Janda for the POSIX.1-2008 TC1 conversion
Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
diff --git a/,xref.1.awk b/,xref.1.awk
new file mode 100755
index 0000000..92515d6
--- /dev/null
+++ b/,xref.1.awk
@@ -0,0 +1,27 @@
+#!/usr/bin/awk -f
+# ,xref.1.awk - convert ,xref.6 to ,xref.1
+#
+# Copyright (C) 2013 Felix Janda
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+# delete first, third and fourth field in each line
+{$1="";$3="";$4=$2;$2=""; print}
diff --git a/,xref.py b/,xref.py
new file mode 100755
index 0000000..3cfd531
--- /dev/null
+++ b/,xref.py
@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+# ,xref.py - Collect xrefs from HTML version of POSIX standard
+#
+# Copyright (C) 2013 Felix Janda
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+import re
+import sys
+import fileinput
+from glob import glob
+from html.entities import entitydefs
+
+sections = [["basedefs"], ["functions"], ["utilities"], ["xrat"]]
+re1 = re.compile('^.*<a name="tag_*|</.*>\n$| Table: | Figure: ')
+re2 = re.compile('">[^>]*</a>')
+re3 = re.compile('^.*> |\..*\n$')
+
+htmlrefs=[] # will be filled with lists of the form ["Chapter 1", "Introduction"]
+files = [] # all V*_chap*.html files
+for s in sections:
+ l = glob(sys.argv[1] + "/" + s[0] + "/V*_chap*.html")
+ l.sort()
+ files = files + l
+for line in fileinput.input(files):
+ if '<a name="tag' in line and not "_foot_" in line:
+ new = [] # To be added to entityrefs
+ prefix = "Section"
+ if "<h2>" in line:
+ prefix = "Chapter"
+ chapter = re3.sub("", line, count=2)
+ table = 1
+ figure = 1
+ elif "Table:" in line:
+ prefix = "Table"
+ new.append(prefix + " " + chapter + "-" + str(table))
+ table += 1
+ elif "Figure:" in line:
+ prefix = "Figure"
+ new.append(prefix + " " + chapter + "-" + str(figure))
+ figure += 1
+
+ line = re1.sub("", re2.sub(" ", line), count=3)
+
+ # Let python deal with the html entities
+ for ent in entitydefs:
+ line = line.replace("&" + ent + ";", entitydefs[ent])
+
+ part = line.partition(" ")
+
+ # Deal with the Sections
+ if not len(new):
+ partpart = part[0].split("_")
+ s = chapter
+ for i in range(1, len(partpart)):
+ s = s + "." + str(int(partpart[i]))
+ new.append(prefix + " " + s)
+
+ new.append(part[2])
+ htmlrefs.append(new)
+
+# Get the label names from ,xref.1 and print the results to stdout
+re4 = re.compile('Chapter|Section|Table|Figure')
+i = 0
+for line in open(",xref.1").readlines():
+ line = line.lstrip(" ").strip("\n")
+ part = line.partition(" ")
+ if re4.match(part[2]):
+ for j in range(i, len(htmlrefs)):
+ if part[2] == htmlrefs[j][0]:
+ print(line + ", " + htmlrefs[j][1])
+ i = j
+ break
+ else:
+ print(line)
+ else:
+ print(line)
diff --git a/README b/README
new file mode 100644
index 0000000..d94b204
--- /dev/null
+++ b/README
@@ -0,0 +1,126 @@
+Conversion of Open Group's troff sources to POSIX man pages
+===========================================================
+
+1. Necessary data:
+==================
+
+- obtainable from The Open Group
+ - directory with the troff sources
+ - file ,xref.6 containing information to crossreferences
+ - file _strings.def containing information to references to other
+ standards
+- obtainable online
+ - the HTML version of the standard
+
+
+The directory of troff sources contains four directories: "Builtins",
+"Commands", "Functions", "Headers". (Some of these contain
+subdirectories with "LEGACY" interfaces.) The directories contain .mm
+and .h files containing groff_mm files with extensions by The Open
+Group. Upon request one can also obtain a file defining their custom
+macros but this file is not necessary for the scripts.
+
+A relevant line in ,xref.6 could look like
+
+gropdf-info:href workdir page 104 Section 3.441
+
+It contains a label ("workdir"), the page number and the
+section number.
+
+A line in _strings.def might look like
+
+.ds Z5 ISO\ POSIX\(hy1 standard
+
+This tells us how to translate the escape sequence \*(Z5 .
+
+The HTML version of the standard can be obtained at
+
+http://pubs.opengroup.org/onlinepubs/9699919799/download/index.html
+
+The relevant files for the scripts are basedefs/V1_chap*.html,
+functions/V2_chap*.html, utilities/V3_chap*.html and
+xrat/V4_*_chap*.html. These are parts of the standard we do not
+have the sources for.
+
+2. Procedure to generate the man pages
+======================================
+
+Change your directory to the directory containing the conversion
+scripts. Type
+
+./,xref.1.awk < ,xref.6 > ,xref.1
+./,xref.py /path/to/HTML_version_of_standard > ,xref
+
+to generate ,xref and
+
+sed -f _strings.sed _strings.def > _strings.
+
+to generate _strings. With this done you can start generating
+individual man pages. To generate all pages use:
+
+./posix.py 0p /path/to/troff_sources/Headers/*.h
+./posix.py 1p /path/to/troff_sources/Built-Ins/*.mm
+./posix.py 1p /path/to/troff_sources/Commands/*.mm
+./posix.py 3p /path/to/troff_sources/Functions/*.mm
+
+You can now find the converted pages in your current working
+directory.
+
+3. Description of the included scripts
+======================================
+
+,xref.1.awk takes ,xref.6 from its standard input, strips
+irrelevant lines and transforms lines of the form
+
+gropdf-info:href whitespace page 103 Section 3.436
+
+to
+
+ whitespace Section 3.436
+
+,xref.1.py expects ,xref.1 generated from ,xref.1.awk in the
+current working directory and the path to the HTML version of
+the standard as its first argument. It extracts section, table
+and figure names for parts of the standard we do not have sources
+for, adds them to the xrefs and writes them to standard output.
+For the example, inside
+
+/path/to/HTML_version_of_standard/basedefs/V1_chap03.html
+
+it finds a line
+
+class; see also <a href="#tag_03_436">White Space</a>.</p>
+
+and therefore outputs
+
+whitespace Section 3.436, White Space
+
+to ,xref.
+
+The sed script _strings.sed does a simple conversion of lines of
+the form
+
+.ds Z5 ISO\ POSIX\(hy1 standard
+
+to
+
+\*(Z5 ISO\ POSIX\(hy1 standard
+
+The main script is posix.py. It takes the name of the man section
+as its first argument and the names of the pages to be converted
+as its other arguments. Furthermore, it expects the data files
+,xref and _strings in its current working directory. It outputs
+converted man pages to its current working directory.
+
+Notes:
+
+A final processing of the xrefs happens in posix.py: On the one
+hand the section names for cross-references internal to the
+current page are added. On the other hand the references to
+other man pages are correctly formatted. The order of the entries
+in ,xref is used to deduce the right section number. This could
+also be achieved by careful examining the source directory.
+
+The code in posix.py to get the indentation right by inserting
+".RS ..." and ".RE" in the right places is very hacky and might
+fail with pages with a slightly more complex structure then now.
diff --git a/_strings.sed b/_strings.sed
new file mode 100755
index 0000000..ba4ca47
--- /dev/null
+++ b/_strings.sed
@@ -0,0 +1,32 @@
+# _strings.sed - convert _strings.def to _strings
+#
+# Copyright (C) 2013 Felix Janda
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+# reformat lines starting with .ds
+/^\.ds .* .*$/{
+s/^\.ds /\\*(/;
+s/ /\t/;
+p
+}
+# delete everything else
+d
diff --git a/posix.py b/posix.py
new file mode 100755
index 0000000..a20bc69
--- /dev/null
+++ b/posix.py
@@ -0,0 +1,354 @@
+#!/usr/bin/env python
+# posix.py - Convert The Open Group troff sources to posix man pages
+#
+# Copyright (C) 2013 Felix Janda
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+import sys
+import os.path
+import re
+
+# Helper for troff()
+def quote(arg):
+ if " " in arg or "\\" in arg: return '"{}"'.format(arg)
+ else: return arg
+
+# troff(".BL", "some text", ",") --> '.B "some text" ,\n'
+def troff(macro, *args):
+ if len(args) == 1 and type(args[0]) is list:
+ args = args[0]
+ args = [quote(arg) for arg in args]
+ s = ".{} {}".format(macro, " ".join(args))
+ return s.strip(" ") + "\n"
+
+# For first processing
+# Replace a macro by a string
+brepl = {"mH":".SH",
+ "Cm":".I",
+ "Ev":".I",
+ "Ar":".I",
+ "yS":".LP\n.nf",
+ "yE":".fi",
+ "Cs":".sp\n.RS 4\n.nf\n\\fB",
+ "Ce":".fi \\fR\n.P\n.RE",
+ "HU":".SS",
+ "cV":".B",
+ "Fi":".B",
+ "rS":'.LP\n.I "The following sections are informative."',
+ "Cd":".I"}
+# Surround the argument of a macro by two strings.
+sur = {"LM":["{", "}"],
+ "Hd":[".I <", "> "],
+ "tK":["<", ">"],
+ "cH":[".B '", "' "],
+ "sG":[".B \\(dq", "\\(dq "],
+ "Fn":["\\fI","\\fR()"],
+ "Er":[".B [", "] "]}
+# Delete a macro
+delete = {"xR",
+ "iX",
+ "sS",
+ "sE",
+ "sP",
+ "TH",
+ "SK",
+ "sT",
+ "mS",
+ "mE",
+ "rE",
+ "po",
+ "if",
+ "ne",
+ "nr",
+ "tr",
+ "in"}
+# Places where we might need to insert .RS to get indentation right
+indentpoint = {"P", "BL", "DL", "VL", "AL", "Cs", "Ns"}
+# Places where we might need to insert .RE to get indentation right
+indentend = {"LE", "LI", "Ne"}
+# Generic replacements in the seconds processing
+repl = {"\\f1":"\\fR",
+ "\\f2":"\\fI",
+ "\\f3":"\\fB",
+ "\\f5":"\\fR",
+ "\\f6":"\\fI",
+ "\\f7":"\\fB",
+ "XBD\n":"the \\*(Zz,\n",
+ "XSH\n":"the \\*(Zy,\n",
+ "XCU\n":"the \\*(Zx,\n",
+ "XRAT\n":"the \\*(zj,\n",
+ "\\*(x":"",
+ "\\*(z!":"",
+ "\\*(z?":"",
+ ".TS H":".TS",
+ "\\(*D":" ",
+ ".B ":".BR ",
+ ".I ":".IR ",
+ '" "$':"$"}
+
+# Here it starts
+
+if len(sys.argv) == 1:
+ progname = os.path.basename(sys.argv[0])
+ sys.stderr.write("Usage: {} SECTION [FILE...]\n".format(progname))
+ exit(2)
+section = sys.argv[1]
+
+# Add the escape sequences from _strings to the repl dictionary
+lines=open("_strings").readlines()
+for l in lines:
+ p = l.partition("\t")
+ repl[p[0]] = p[2].strip("\n")
+
+# Generate refdictorig from the ,xref file. It will be later extended to
+# the refdict dictionary with table and figure names from the current man
+# page
+refdictregs = [[r'\\fB<([a-zA-Z0-9\._/]*)>\\fP$', r'.BR \1 ({}p)'],
+ [r'\\fI([a-zA-Z0-9_]*)\\fR\\\^\(\\\|\)$', r'.BR \1 ({}p)'],
+ [r'\\fI([a-zA-Z0-9]*)\\fR\\\^$', r'.BR \1 ({}p)']]
+refdictorig = dict()
+lines = open(",xref").readlines()
+nsec = -1 # current section
+for l in lines:
+ if l.startswith("intro_"): nsec += 1
+ p = l.partition(" ")
+ s = p[2].strip("\n").replace(', ', '" ", " "')
+ for reg in refdictregs: # Format references to other man pages
+ s = re.sub(reg[0], reg[1].format([0, 3, 1][nsec]), s)
+ if s[0] != ".": # Otherwise make it italic
+ s = '.I "{}"'.format(s)
+ if ".h" in s: s = s.replace("/", "_") # for <sys/types.h>
+ refdictorig[p[0]] = s
+
+for file in sys.argv[2:]:
+ input = open(file)
+ lines = input.readlines()
+ input.close()
+
+ # Complete the ref descriptions
+ refdict = refdictorig
+ for i, l in enumerate(lines):
+ l = l.strip("\n")
+ if l.startswith(".xR ") and l[4] in ["6", "7"]:
+ key = l.split(" ")[2]
+ # Add numbers to tables and figures in current page
+ lines[i - 1] += ' " ' + refdict[key].split(" ")[2]
+ refdict[key] = '{}, {}"'.format(refdict[key].strip('"'),
+ prev.split(' "')[1].strip('"'))
+ prev = l
+
+ in_DSI = 0 # Are we in a display?
+ list_stack = [["BL"]] # stack of groff_mm lists we are in
+ list_num_stack = [] # stack of current list item numbers
+ needindent = 0 # do we need to insert .RS before the next paragraph?
+
+ # First processing
+ for i, l in enumerate(lines):
+ # only consider lines with macros
+ if not l or l[0] != ".": continue
+
+ # read out macro name with its arguments
+ macro = l.strip("\n").partition(" ")[0][1:]
+ args = ["".join(t) for t in re.findall(r'([^\s"][^\s]*"*)|"([^"]*)"',
+ l.strip("\n"))][1:]
+
+ # strip comments
+ if macro.startswith('\\"'): lines[i] = ""
+
+ insert = "" # string to be inserted in front of current line
+ if needindent > 0:
+ if macro in indentpoint:
+ insert = ".RS {} \n".format(needindent)
+ needindent = -1
+ if needindent == -1 and macro in indentend:
+ insert = ".RE\n"
+
+ # "Note:" macros
+ if macro == "Ns":
+ lines[i] = ".TP 10\n.B Note"
+ if args: lines[i] += "s"
+ lines[i] += ":\n"
+ needindent = 10
+ if macro == "Ne":
+ lines[i] = troff("P")
+ needindent = -1
+
+ # Read the name of the current man page from the mS macro
+ if macro == "mS": name = args[0]
+
+ # mm display macros
+ if macro == "DS":
+ if "I" in args:
+ lines[i] = ".sp\n.RS\n"
+ in_DSI = 1
+ else: lines[i] = ""
+ elif macro == "DE":
+ if in_DSI: lines[i] = troff("RE")
+ else: lines[i] = ""
+ in_DSI = 0
+
+ # Fix table and figure captions
+ if macro == "TB":
+ if len(args) == 1: args.append("")
+ lines[i] = ".sp\n.ce 1\n\\fBTable{}: {}\\fR\n".format(args[1], args[0])
+ elif macro == "FG":
+ if len(args) == 1: args.append("")
+ lines[i] = ".sp\n.ce 1\n\\fBFigure{}: {}\\fR\n".format(args[1], args[0])
+ # strip unecessary macros around figures
+ elif macro == "F+":
+ lines[i] = lines[i + 1] = lines[i + 2] = ""
+
+ # mm list macro processing
+ elif macro in {"BL", "DL", "VL", "AL"}: # start of a list
+ needindent = 0
+ list_stack.insert(0, [macro, args])
+ if list_stack[0][0] == "AL":
+ list_num_stack.insert(0, 1)
+ lines[i] = ""
+ elif macro == "LI": # list item
+ # Strip some unecessary escape sequences to make the regexes for
+ # formatting the ERRORS section happy
+ if args: args[0] = args[0].replace("\\*!", "")
+
+ needindent = 4
+ if list_stack[0][0] == "BL": # bullet list
+ li_args = [" *", "4"]
+ elif list_stack[0][0] == "DL": # dashed list
+ li_args = ["--", "4"]
+ elif list_stack[0][0] == "VL": # variable item list
+ needindent = (int(list_stack[0][1][0]) - 8) // 2 + 8
+ li_args = [args[0], str(needindent)]
+ elif list_stack[0][0] == "AL": # advanced list
+ num = list_num_stack[0]
+ s = ""
+ if not list_stack[0][1]: # 1. 2. 3.
+ s = str(num)
+ elif list_stack[0][1][0] == "a": # a. b. c.
+ s = chr(num + 96)
+ elif list_stack[0][1][0] == "i": # i. ii. iii.
+ needindent += 1
+ s = "".join(["i" for j in range(num)])
+ li_args = ["{:>2s}.".format(s), str(needindent)]
+ list_num_stack[0] += 1
+ lines[i] = troff("IP", li_args)
+ elif macro == "LE": # list end
+ if list_stack[0][0] == "AL":
+ del list_num_stack[0]
+ del list_stack[0]
+ lines[i] = ""
+ needindent = -1
+ if len(list_stack) >= 2:
+ lines[i] = troff("LE") + troff("RE")
+
+ # References
+ elif macro == "cX":
+ key = args[0]
+ if key in refdict: s = refdict[key]
+ else: s = key
+ if len(args) > 1: s += args[1]
+ lines[i] = s + "\n"
+
+ # Generic replacements
+ if macro in delete:
+ lines[i] = ""
+ elif macro in brepl:
+ lines[i] = l.replace("." + macro, brepl[macro], 1)
+ elif macro in sur:
+ lines[i] = sur[macro][0] + args[0] + sur[macro][1] + " ".join(args[1:]) + "\n"
+
+ lines[i] = insert + lines[i]
+
+ # Second processing
+ in_SEE_ALSO = 0 # Are we in the SEE ALSO section?
+ in_EQ = 0 # Are we in a displayed equation?
+ for i, l in enumerate(lines):
+ if l == ".SH \"SEE ALSO\"\n":
+ in_SEE_ALSO = 1
+ elif l == ".SH \"CHANGE HISTORY\"\n":
+ lines = lines[:i] # We are not allowed to include the CHANGE HISTORY
+ break
+ elif l == ".EQ\n":
+ in_EQ = 1
+ elif l == ".EN\n":
+ in_EQ = 0
+ # hack the equations to be a bit better readable on terminals
+ if in_EQ or '$' in l:
+ l = re.sub(r' sup ([a-zA-Z0-9\\\(]*)', "\"^\" \\1\" \"", l)
+ l = re.sub(r' sub ([a-zA-Z0-9\\\(]*)', "_ \\1\" \"", l)
+ l = l.replace("left { ~\n", "")
+ l = l.replace("~", ' " " ')
+ # reformat the error codes in the ERRORS section
+ l = re.sub(r'.IP \[(E[0-9A-Z]*)\] [0-9]*\n', ".TP\n.B \\1\n", l)
+ l = re.sub(r'.IP "\[(E[0-9A-Z]*)\] or \[(E[0-9A-Z]*)\]" [0-9]*\n',
+ ".TP\n.BR \\1 \" or \" \\2\n", l)
+ # Strip some extra space in the beginning of lines
+ l = re.sub(r'^\\ ', "", l)
+ # Generic replacements
+ for me in repl:
+ l = l.replace(me, repl[me])
+ for me in repl: # To be sure...
+ l = l.replace(me, repl[me])
+ if in_SEE_ALSO: l = re.sub(r'^the', "The", l)
+ lines[i] = l
+
+ name = re.sub(r'^<|>$', r'', name).replace("/", "_")
+ # name printed on the top of the man page
+ if section != "0p": NAME = name.upper()
+ else: NAME = name
+ lines.insert(0,
+ "'\\\" et\n"
+ ".TH {} \"{}\" 2013 \"IEEE/The Open Group\" \"POSIX Programmer's Manual\"\n"
+ ".SH PROLOG\n"
+ "This manual page is part of the POSIX Programmer's Manual.\n"
+ "The Linux implementation of this interface may differ (consult\n"
+ "the corresponding Linux manual page for details of Linux behavior),\n"
+ "or the interface may not be implemented on Linux.\n"
+ "\n"
+ "".format(NAME, section.upper()))
+ lines.append(
+ ".SH COPYRIGHT\n"
+ "Portions of this text are reprinted and reproduced in electronic form\n"
+ "from IEEE Std 1003.1, 2013 Edition, Standard for Information Technology\n"
+ "-- Portable Operating System Interface (POSIX), The Open Group Base\n"
+ "Specifications Issue 7, Copyright (C) 2013 by the Institute of\n"
+ "Electrical and Electronics Engineers, Inc and The Open Group.\n"
+ "(This is POSIX.1-2008 with the 2013 Technical Corrigendum 1 applied.) In the\n"
+ "event of any discrepancy between this version and the original IEEE and\n"
+ "The Open Group Standard, the original IEEE and The Open Group Standard\n"
+ "is the referee document. The original Standard can be obtained online at\n"
+ "http://www.unix.org/online.html .\n"
+ "\n"
+ "Any typographical or formatting errors that appear\n"
+ "in this page are most likely\n"
+ "to have been introduced during the conversion of the source files to\n"
+ "man page format. To report such errors, see\n"
+ "https://www.kernel.org/doc/man-pages/reporting_bugs.html .\n"
+ )
+
+ text = "".join(lines)
+ # Final hacks for the indentation
+ for i in [[".LE\n.RE\n.P", ".P"], [".LE\n.RE\n.RE", ".RE"],
+ [".RE\n.LE\n.RE", ".RE"], ["\n.LE\n", "\n"]]:
+ text = text.replace(i[0], i[1])
+ output = open(name + "." + section, 'w')
+ output.write(text)
+ output.close()
