Commit d329f8ff authored by Fabian Wolff's avatar Fabian Wolff

New upstream version 2.18

parent 672162a9
......@@ -59,16 +59,20 @@ dist: doclifter-$(VERSION).tar.gz
clean:
rm -f doclifter.html manlifter.html doclifter.1 manlifter.1
rm -f *.pyc docliftertest.xml foobar* fixed* *~ bugs.html
rm -f index.html *.tar.gz *.md5
rm -f index.html *.tar.gz *.md5 *old
release: doclifter-$(VERSION).tar.gz doclifter-$(VERSION).md5 doclifter.html manlifter.html
shipper version=$(VERSION) | sh -e -x
refresh: doclifter.html manlifter.html
htmlclean: rm *.html
refresh: htmlclean doclifter.html manlifter.html
shipper -N -w version=$(VERSION) | sh -e -x
# This is used only for updating the bugs page on my website.
# It won't work for anyone else.
REMOTE=esr@login.ibiblio.org
UPDIR=/public/html/catb/esr/doclifter
update:
problemgen.py >bugs.html
scp -r bugs.html prepatch/ login.ibiblio.org:/public/html/catb/esr/doclifter
ssh $(REMOTE) rm -fr $(UPDIR)/prepatch
scp -r bugs.html prepatch/ $(REMOTE):$(UPDIR)
This diff is collapsed.
This diff is collapsed.
'\" t
.\" Title: doclifter
.\" Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\" Date: 03/08/2016
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 06/12/2018
.\" Manual: Documentation Tools
.\" Source: doclifter
.\" Language: English
.\"
.TH "DOCLIFTER" "1" "03/08/2016" "doclifter" "Documentation Tools"
.TH "DOCLIFTER" "1" "06/12/2018" "doclifter" "Documentation Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
......@@ -31,7 +31,7 @@
doclifter \- translate troff requests into DocBook
.SH "SYNOPSIS"
.HP \w'\fBdoclifter\fR\ 'u
\fBdoclifter\fR [\-e\ \fIoutput\-encoding\fR] [\-i\ \fIinput\-encodings\fR] [\-h\ \fIhintfile\fR] [\-q] [\-x] [\-v] [\-w] [\-V] [\-D\ \fItoken=type\fR] [\-I\ \fIpath\fR] [\-S\ \fIspoofname\fR] \fIfile\fR...
\fBdoclifter\fR [\-o\ \fIoutput\-location\fR] [\-e\ \fIoutput\-encoding\fR] [\-i\ \fIinput\-encodings\fR] [\-h\ \fIhintfile\fR] [\-q] [\-x] [\-v] [\-w] [\-V] [\-D\ \fItoken=type\fR] [\-I\ \fIpath\fR] [\-S\ \fIspoofname\fR] \fIfile\fR...
.SH "DESCRIPTION"
.PP
\fBdoclifter\fR
......@@ -87,6 +87,11 @@ acts as a filter, translating troff source input on standard input to DocBook ma
\&.xml
is given to the translated output\&.
.PP
\-o
.RS 4
Set the output location where files will be saved\&. Defaults to current working directory\&.
.RE
.PP
\-h
.RS 4
Name a file to which information on semantic hints gathered during analysis should be written\&.
......@@ -288,6 +293,7 @@ Certain extension macros originally defined under Ultrix are translated structur
(and the synonyms
\fB\&.Ex\fR/\fB\&.Ee\fR),
\fB\&.Ds\fR/\fB\&.De\fR,
\fB\&.NT\fR/\fB\&.NE\fR,
\fB\&.PN\fR, and
\fB\&.MS\fR
......@@ -299,7 +305,8 @@ The following extension macros used by the X distribution are also recognized an
\fB\&.IN\fR,
\fB\&.ZN\fR,
\fB\&.hN\fR, and
\fB\&.C{\fR/\fB\&.C}\fRThe
\fB\&.C{\fR/\fB\&.C}\fR
The
\fB\&.TA\fR
and
\fB\&.IN\fR
......@@ -549,7 +556,8 @@ The following macros are structurally translated:
\fB\&.BVL\fR,
\fB\&.VL\fR,
\fB\&.DE\fR,
\fB\&.DL\fR\fB\&.DS\fR,
\fB\&.DL\fR
\fB\&.DS\fR,
\fB\&.FE\fR,
\fB\&.FS\fR,
\fB\&.H\fR,
......@@ -621,7 +629,6 @@ The following macros are ignored:
The following macros generate warnings:
\fB\&.EC\fR,
\fB\&.EX\fR,
\fB\&.FG\fR,
\fB\&.GETHN\fR,
\fB\&.GETPN\fR,
\fB\&.GETR\fR,
......@@ -641,6 +648,12 @@ The following macros generate warnings:
\fB\&.RE\fR,
\fB\&.SETR\fR
.PP
Pairs of
\fB\&.DS\fR/\fB\&.DE\fR
are interpreted as informal figures\&. If an
\fB\&.FG\fR
is present it becomes a caption element\&.
.PP
\ \&\fB\&.BS\fR/\fB\&.BE\fR
and
\fB\&.IA\fR/\fB\&.IE\fR
......
......@@ -18,6 +18,7 @@
<cmdsynopsis>
<command>doclifter</command>
<arg choice='opt'>-o <replaceable>output-location</replaceable></arg>
<arg choice='opt'>-e <replaceable>output-encoding</replaceable></arg>
<arg choice='opt'>-i <replaceable>input-encodings</replaceable></arg>
<arg choice='opt'>-h <replaceable>hintfile</replaceable></arg>
......@@ -107,6 +108,13 @@ file is translated separately (but hints are retained, see below); the
suffix <filename>.xml</filename> is given to the translated output.</para>
<variablelist>
<varlistentry>
<term>-o</term>
<listitem>
<para>Set the output location where files will be saved. Defaults to current
working directory.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-h</term>
<listitem>
<para>Name a file to which information on semantic hints gathered
......@@ -515,7 +523,7 @@ with false positives.</para>
<markup>.VM</markup>, <markup>.WC</markup>.</para>
<para>The following macros generate warnings: <markup>.EC</markup>,
<markup>.EX</markup>, <markup>.FG</markup>, <markup>.GETHN</markup>,
<markup>.EX</markup>, <markup>.GETHN</markup>,
<markup>.GETPN</markup>, <markup>.GETR</markup>,
<markup>.GETST</markup>, <markup>.LT</markup>, <markup>.LD</markup>,
<markup>.LO</markup>, <markup>.MOVE</markup>, <markup>.MULB</markup>,
......@@ -525,6 +533,10 @@ with false positives.</para>
<markup>.SETR</markup>
</para>
<para>Pairs of <markup>.DS</markup>/<markup>.DE</markup> are
interpreted as informal figures. If an <markup>.FG</markup> is
present it becomes a caption element.</para>
<para>&nbsp;<markup>.BS</markup>/<markup>.BE</markup> and
<markup>.IA</markup>/<markup>.IE</markup> pairs are passed through.
The text inside them may need to be deleted or moved.</para>
......
This diff is collapsed.
'\" t
.\" Title: manlifter
.\" Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\" Date: 06/03/2014
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 06/12/2018
.\" Manual: Documentation Tools
.\" Source: manlifter
.\" Language: English
.\"
.TH "MANLIFTER" "1" "06/03/2014" "manlifter" "Documentation Tools"
.TH "MANLIFTER" "1" "06/12/2018" "manlifter" "Documentation Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
......@@ -133,14 +133,6 @@ foo\&.N\&.patch
is interpreted as a patch to be applied to the manual page foo(N) before doclifter translates it\&.
.RE
.PP
\-P
.RS 4
Enable profiling using the Python hotshot module; this is only useful for tuning
doclifter
so it runs faster\&. Raw data is written to
manlifter\&.prof, and a digested report is appended to the log on standard output\&. Warning: the raw data files can become huge, and the postprocessing for report generation can take as long as the actual processing (or longer!)\&.
.RE
.PP
\-q
.RS 4
Normally, pass the \-q (quiet) option to each doclifter call\&. In error\-filter mode, return a list of files on which translation failed\&.
......
......@@ -151,16 +151,6 @@ interpreted as a patch to be applied to the manual page foo(N) before
doclifter translates it.</para></listitem>
</varlistentry>
<varlistentry>
<term>-P</term>
<listitem><para>Enable profiling using the Python hotshot module; this
is only useful for tuning <application>doclifter</application> so it
runs faster. Raw data is written to
<filename>manlifter.prof</filename>, and a digested report is appended
to the log on standard output. Warning: the raw data files can become
huge, and the postprocessing for report generation can take as long
as the actual processing (or longer!).</para></listitem>
</varlistentry>
<varlistentry>
<term>-q</term>
<listitem><para>Normally, pass the -q (quiet) option to each doclifter call.
In error-filter mode, return a list of files on which translation failed.
......
......@@ -1276,10 +1276,8 @@ digit (${1}0 in sh(1)).</para>
<para>The following will draw a line with slope 1.</para>
<programlisting remap='Bd'>
<synopsis>
define foo { next at $1, $2 }
for i from 1 to 5 { foo(i,i) }
</synopsis>
</programlisting> <!-- remap='Ed (block)' -->
<para>Macros persist across graphs. The file
<filename>/usr/local/share/grap/grap.defines</filename>
......
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<!-- lifted from man+troff by doclifter -->
<refentry>
<!-- Reduced version exhibiting a bunch of OpenSSL werdnesses -->
<refentryinfo><date>2018-04-25</date></refentryinfo>
<refmeta>
<refentrytitle>DEFINE_STACK_OF</refentrytitle>
<manvolnum>3SSL</manvolnum>
<refmiscinfo class='date'>2018-04-25</refmiscinfo>
<refmiscinfo class='source'>1.1.0g</refmiscinfo>
<refmiscinfo class='manual'>OpenSSL</refmiscinfo>
</refmeta>
<refnamediv>
<refname>DEFINE_STACK_OF</refname>
<refname>DEFINE_STACK_OF_CONST</refname>
<refname>DEFINE_SPECIAL_STACK_OF</refname>
<refname>DEFINE_SPECIAL_STACK_OF_CONST</refname>
<refname>sk_TYPE_deep_copy</refname>
<refname>sk_TYPE_set_cmp_func</refname>
<refpurpose>stack container</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<funcsynopsis>
<funcsynopsisinfo>
#include &lt;openssl/safestack.h&gt;
STACK_OF(TYPE)
DEFINE_STACK_OF(TYPE)
DEFINE_STACK_OF_CONST(TYPE)
DEFINE_SPECIAL_STACK_OF(FUNCTYPE, TYPE)
DEFINE_SPECIAL_STACK_OF_CONST(FUNCTYPE, TYPE)
typedef int (*sk_TYPE_compfunc)(const TYPE *const *a, const TYPE *const *b);
typedef TYPE * (*sk_TYPE_copyfunc)(const TYPE *a);
typedef void (*sk_TYPE_freefunc)(TYPE *a);
</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>sk_TYPE_num</function></funcdef>
<paramdef>const STACK_OF(TYPE) * <parameter>sk</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>STACK_OF(TYPE) *<function>sk_TYPE_deep_copy</function></funcdef>
<paramdef>const STACK_OF(TYPE) * <parameter>sk</parameter></paramdef>
<paramdef>sk_TYPE_copyfunc <parameter>copyfunc</parameter></paramdef>
<paramdef>sk_TYPE_freefunc <parameter>freefunc</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef><function>sk_TYPE_compfunc</function></funcdef>
<paramdef>* <parameter>sk_TYPE_set_cmp_func</parameter>( STACK_OF(TYPE) *sk , sk_TYPE_compfunc compare )</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='description'><title>DESCRIPTION</title>
<para><indexterm><primary>Header</primary><secondary>DESCRIPTION</secondary></indexterm>
Applications can create and use their own stacks by placing any of the macros
described below in a header file. These macros define typesafe inline
functions that wrap around the utility <emphasis role='strong' remap='B'>OPENSSL_sk_</emphasis> <?troff ps -1?>API.<?troff ps 0?>
In the description here, <emphasis remap='I'><?troff ps -1?>TYPE<?troff ps 0?></emphasis> is used
as a placeholder for any of the OpenSSL datatypes, such as <emphasis remap='I'>X509</emphasis>.</para>
</refsect1>
</refentry>
.\" Reduced version exhibiting a bunch of OpenSSL werdnesses
.IX Title "DEFINE_STACK_OF 3SSL"
.TH DEFINE_STACK_OF 3SSL "2018-04-25" "1.1.0g" "OpenSSL"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
DEFINE_STACK_OF, DEFINE_STACK_OF_CONST, DEFINE_SPECIAL_STACK_OF,
DEFINE_SPECIAL_STACK_OF_CONST, sk_TYPE_deep_copy, sk_TYPE_set_cmp_func \-
stack container
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& #include <openssl/safestack.h>
\&
\& STACK_OF(TYPE)
\& DEFINE_STACK_OF(TYPE)
\& DEFINE_STACK_OF_CONST(TYPE)
\& DEFINE_SPECIAL_STACK_OF(FUNCTYPE, TYPE)
\& DEFINE_SPECIAL_STACK_OF_CONST(FUNCTYPE, TYPE)
\&
\& typedef int (*sk_TYPE_compfunc)(const TYPE *const *a, const TYPE *const *b);
\& typedef TYPE * (*sk_TYPE_copyfunc)(const TYPE *a);
\& typedef void (*sk_TYPE_freefunc)(TYPE *a);
\&
\& int sk_TYPE_num(const STACK_OF(TYPE) *sk);
\& STACK_OF(TYPE) *sk_TYPE_deep_copy(const STACK_OF(TYPE) *sk,
\& sk_TYPE_copyfunc copyfunc,
\& sk_TYPE_freefunc freefunc);
\& sk_TYPE_compfunc (*sk_TYPE_set_cmp_func(STACK_OF(TYPE) *sk, sk_TYPE_compfunc compare));
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Applications can create and use their own stacks by placing any of the macros
described below in a header file. These macros define typesafe inline
functions that wrap around the utility \fBOPENSSL_sk_\fR \s-1API.\s0
In the description here, \fI\s-1TYPE\s0\fR is used
as a placeholder for any of the OpenSSL datatypes, such as \fIX509\fR.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment