[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: gideal: new version 0.9.6; make man-pages compatible to d
|
From: |
Bernd Warken |
|
Subject: |
[groff] 01/01: gideal: new version 0.9.6; make man-pages compatible to doclifter |
|
Date: |
Sun, 06 Jul 2014 09:44:38 +0000 |
bwarken pushed a commit to branch master
in repository groff.
commit 26558fc27956cf3ce9f2d8cd70cc4ae818d339e8
Author: Bernd Warken <address@hidden>
Date: Sun Jul 6 11:44:31 2014 +0200
gideal: new version 0.9.6; make man-pages compatible to doclifter
---
contrib/gideal/ChangeLog | 6 +
contrib/gideal/gideal.man | 123 ++++++++++--------
contrib/gideal/gideal.pl | 4 +-
contrib/gideal/ideal.man | 112 +++++++++--------
contrib/gideal/ideal.man.xml | 285 ++++++++++++++++++++++++++++++++++++++++++
5 files changed, 419 insertions(+), 111 deletions(-)
diff --git a/contrib/gideal/ChangeLog b/contrib/gideal/ChangeLog
index 28b2db5..e2638d0 100644
--- a/contrib/gideal/ChangeLog
+++ b/contrib/gideal/ChangeLog
@@ -1,5 +1,11 @@
2014-07-04 Bernd Warken <address@hidden>
+ * gideal.pl: New version 0.9.6
+
+ * gideal.man, ideal.man: Make man-pages compatible to `doclifter'.
+
+2014-07-04 Bernd Warken <address@hidden>
+
* gideal.pl: New version 0.9.5
* gideal.man, ideal.man: Transport man-pages to classical format.
diff --git a/contrib/gideal/gideal.man b/contrib/gideal/gideal.man
index f41ce6a..d4bf4d1 100644
--- a/contrib/gideal/gideal.man
+++ b/contrib/gideal/gideal.man
@@ -1,7 +1,7 @@
.\" t
.TH GIDEAL @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
.SH NAME
-gideal \[em] \f[I]groff\f[] preprocessor for the \f[I]ideal\f[] language
+gideal \(em \fIgroff\fP preprocessor for the \fIideal\fP language
.
.\" The .SH was moved to this place in order to appease `apropos'.
.
@@ -11,64 +11,41 @@ gideal \[em] \f[I]groff\f[] preprocessor for the
\f[I]ideal\f[] language
.
.ig
gideal.1 - man page for the ideal roff preprocessor
-.
+
Source file position: <groff_source_top>/contrib/gideal/gideal.man
Installed position: $prefix/share/man/man1/gideal.1
+
+Last update: 5 Jul 2014
+
+This file was written by Bernd Warken <address@hidden>
.
-Last update: 4 Jul 2014
-..
-.
-.de authors
-This file was written by Bernd Warken
-.MT address@hidden
-.ME .
-..
-.
-.de copying
Copyright \(co 2014
-.RS
-.ft CI
-Free Software Foundation, Inc.
-.ft R
-.RE
-.
-.P
-This file is part of
-.IR \%gideal ,
-which is part of
-.IR \%groff ,
-a free software project.
-.
+ Free Software Foundation, Inc.
+
+This file is part of `gideal', which is part of `groff', a free
+software project.
+
You can redistribute it and/or modify it under the terms of the
-.nh
-.ft CI
-GNU General Public License
-.ft R
-.hy
-as published by the
-.nh
-.ft CI
-Free Software Foundation version\~2
-.ft R
-.hy
-(\\f[CI]GPL2\\f[R]).
-.
-.P
+`GNU General Public License version 2' (GPL2), as published by the
+`Free Software Foundation'.
+
The license text is available in the internet at
-.UR http://www.gnu.org/licenses/gpl-2.0.html
-.UE .
+<http://www.gnu.org/licenses/gpl-2.0.html>.
..
.
.\" --------------------------------------------------------------------
.\" Characters
.\" --------------------------------------------------------------------
.
-.ie t .char \[Ellipsis] \f[S]\N'188'\f[P]
-.el .char \[Ellipsis] \&.\|.\|.\&\
-.\" called by \[Ellipsis]
+.\" Ellipsis ...
+.ie t .ds EL \fS\N'188'\fP
+.el .ds EL \&.\|.\|.\&\
+.\" called with \*(EL
.
-.ie t .char \[Bullet] \[bu]
-.el .char \[Bullet] \-
+.\" Bullet
+.ie t .ds BU \(bu
+.el .ds BU *
+.\" used in `.IP \*(BU 2m' (former .Topic)
.
.
.\" --------------------------------------------------------------------
@@ -78,7 +55,7 @@ The license text is available in the internet at
.SY gideal
.OP \-
.OP \-\-
-.OP \fI\%filespec \[Ellipsis]
+.OP \fI\%filespec \*(EL
.YS
.
.BR "gideal \-h" | "\-\-help"
@@ -88,7 +65,7 @@ The license text is available in the internet at
.
.\" --------------------------------------------------------------------
.SH DESCRIPTION
-..\" --------------------------------------------------------------------
+.\" --------------------------------------------------------------------
.
.BR ideal (@MAN7EXT@)
is a
@@ -112,9 +89,9 @@ for using this language within
In
.BR gideal ,
there are the following kinds of options:
-.IP \[Bullet] 2m
+.IP \*(BU 2m
.I breaking options
-.IP \[Bullet] 2m
+.IP \*(BU 2m
.I filespec options
.
.
@@ -267,7 +244,7 @@ get into
Some
.I roff
files with included
-.Iideal parts
+.I ideal parts
will be stored at the installation into
.BR @EXAMPLEDIR@/ideal .
.
@@ -352,14 +329,52 @@ Christopher J. Van Wyk
.SH "AUTHORS"
.\" --------------------------------------------------------------------
.
-.authors
-.
+This file was written by
+.MT address@hidden
+Bernd Warken
+.ME .
+..
.
.\" --------------------------------------------------------------------
.SH "COPYING"
.\" --------------------------------------------------------------------
.
-.copying
+Copyright \(co 2014
+.RS
+.ft CI
+Free Software Foundation, Inc.
+.ft R
+.RE
+.
+.P
+This file is part of
+.IR \%gideal ,
+which is part of
+.IR \%groff ,
+a free software project.
+.
+You can redistribute it and/or modify it under the terms of the
+.nh
+.ft CI
+GNU General Public License version 2
+.R
+(GPL2).
+.hy
+as published by the
+.nh
+.ft CI
+Free Software Foundation.
+.ft R
+.hy
+.
+.
+The license text is available in the internet at
+.UR http://\:www.gnu.org/\:licenses/\:gpl-2.0.html
+.UE .
+..
+.
+.
+.
.
.
.\" --------------------------------------------------------------------
diff --git a/contrib/gideal/gideal.pl b/contrib/gideal/gideal.pl
index d119168..18765c5 100755
--- a/contrib/gideal/gideal.pl
+++ b/contrib/gideal/gideal.pl
@@ -10,8 +10,8 @@
# Written by Bernd Warken <address@hidden>.
-my $Latest_Update = '4 Jul 2014';
-my $version = '0.9.5';
+my $Latest_Update = '6 Jul 2014';
+my $version = '0.9.6';
# This file is part of `gideal', which is part of `groff'.
diff --git a/contrib/gideal/ideal.man b/contrib/gideal/ideal.man
index b430ae0..1e2af3b 100644
--- a/contrib/gideal/ideal.man
+++ b/contrib/gideal/ideal.man
@@ -1,6 +1,6 @@
.TH IDEAL @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
.SH NAME
-ideal \[em] the groff \f[I]ideal\f[] language
+ideal \[em] the groff \fIideal\fP language
.
.\" The .SH was moved to this place in order to appease `apropos'.
.
@@ -10,67 +10,31 @@ ideal \[em] the groff \f[I]ideal\f[] language
.
.ig
ideal.7 - man page for the ideal roff language
-.
+
Source file position: <groff_source_top>/contrib/gideal/ideal.man
Installed position: $prefix/share/man/man7/ideal.7
.
Last update: 4 Jul 2014
-..
-.
-.de authors
-This file was written by Bernd Warken
-.MT address@hidden
-.ME .
-..
-.
-.de copying
-Copyright \(co 2014
-.RS
-.ft CI
-Free Software Foundation, Inc.
-.ft R
-.RE
-.
-.P
-This file is part of
-.IR \%ideal ,
-which is part of
-.IR \%groff ,
-a free software project.
-.
-You can redistribute it and/or modify it under the terms of the
-.nh
-.ft CI
-GNU General Public License
-.ft R
-.hy
-as published by the
-.nh
-.ft CI
-Free Software Foundation version\~2
-.ft R
-.hy
-(\\f[CI]GPL2\\f[R]).
-.
-.P
+
+This file was written by Bernd Warken <address@hidden>.
+
+Copyright 2014
+ Free Software Foundation, Inc.
+
+This file is part of `ideal', which is part of `groff', a free
+software project.
+
+You can redistribute it and/or modify it under the terms of the `GNU
+General Public License version 2' (GPL2) as published by the `Free
+Software Foundation'.
+
The license text is available in the internet at
-.UR http://www.gnu.org/licenses/gpl-2.0.html
-.UE .
+<http://www.gnu.org/licenses/gpl-2.0.html>.
..
.
-.
-.\" --------------------------------------------------------------------
-.\" Characters
-.\" --------------------------------------------------------------------
-.
-.ie t .char \[Ellipsis] \f[S]\N'188'\f[P]
-.el .char \[Ellipsis] \f[I]...\f[P]
-.\" called by \[Ellipsis]
-.
-.
.\" --------------------------------------------------------------------
.SH DESCRIPTION
-..\" --------------------------------------------------------------------
+.\" --------------------------------------------------------------------
.
.BR ideal (@MAN7EXT@)
is a
@@ -255,15 +219,53 @@ Christopher J. Van Wyk
.SH "AUTHORS"
.\" --------------------------------------------------------------------
.
-.authors
+Last update: 5 Jul 2014
+.
+.
+.P
+This file was written by
+.MT address@hidden
+Bernd Warken
+.ME .
.
.
.\" --------------------------------------------------------------------
.SH "COPYING"
.\" --------------------------------------------------------------------
.
-.copying
+Copyright \(co 2014
+.RS
+.ft CI
+Free Software Foundation, Inc.
+.ft R
+.RE
.
+.P
+This file is part of
+.IR \%ideal ,
+which is part of
+.IR \%groff ,
+a free software project.
+.
+You can redistribute it and/or modify it under the terms of the
+.nh
+.ft CI
+GNU General Public License
+.ft R
+.hy
+as published by the
+.nh
+.ft CI
+Free Software Foundation version\~2
+.ft R
+.hy
+(\\f[CI]GPL2\\f[R]).
+.
+.P
+The license text is available in the internet at
+.UR http://www.gnu.org/licenses/gpl-2.0.html
+.UE .
+..
.
.\" --------------------------------------------------------------------
.\" Emacs settings
diff --git a/contrib/gideal/ideal.man.xml b/contrib/gideal/ideal.man.xml
new file mode 100644
index 0000000..14e8676
--- /dev/null
+++ b/contrib/gideal/ideal.man.xml
@@ -0,0 +1,285 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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 id='idealman'>
+<refmeta>
+<refentrytitle>IDEAL</refentrytitle>
+<manvolnum>@MAN7EXT@</manvolnum>
+<refmiscinfo class='source'>@MDATE@</refmiscinfo>
+<refmiscinfo class='manual'>Groff Version @VERSION@</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>ideal — the groff ideal language ideal.7</refname>
+<refpurpose>man page for the ideal roff language Source file position:
<groff_source_top>/contrib/gideal/ideal.man Installed position:
$prefix/share/man/man7/ideal.7 Last update: 4 Jul 2014 This file was written by
Bernd Warken <address@hidden>. Copyright 2014 Free Software Foundation,
Inc. This file is part of `ideal', which is part of `groff', a free software
project. You can redistribute it and/or modify it under the terms of the `GNU
General Public License versi [...]
+</refnamediv>
+<!-- body begins here -->
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+
+<para><emphasis remap='B'>ideal</emphasis>(@MAN7EXT@)
+is a
+<emphasis remap='I'>roff</emphasis>
+language for drawing pictures.
+
+<emphasis remap='B'>gideal</emphasis>(@MAN1EXT@)
+is the corresponding
+<emphasis remap='I'>groff</emphasis>
+preprocessor for using this language within
+<emphasis remap='I'>groff files</emphasis>
+(to be done).</para>
+
+
+
+</refsect1>
+
+<refsect1 id='ideal_parts'><title>IDEAL PARTS</title>
+
+<para>Within a roff file, an
+<emphasis remap='I'>ideal part</emphasis>
+is started with the command
+<markup>.IS</markup>.</para>
+
+
+
+<para>this part is ended with the command
+<markup>.IE</markup>
+or
+<markup>.IF</markup>.</para>
+
+
+
+<para>The text between these requests is handled by the preprocessor
+<emphasis remap='B'>gideal</emphasis>(@MAN1EXT@).</para>
+
+
+
+</refsect1>
+
+<refsect1 id='history'><title>HISTORY</title>
+
+<para>The roff preprocessor and the roff language
+<emphasis remap='I'>ideal</emphasis>
+were invented by
+<emphasis remap='I'>Christopher J. Wyk</emphasis>
+in 1981 at AT&T.</para>
+
+
+
+<para>The
+<emphasis remap='I'>ideal language</emphasis>
+is based on
+<emphasis remap='I'>complex numbers</emphasis>.
+
+These are well documented at the documentation of the
+<ulink
url='http://search.cpan.org/~zefram/Math-Complex-1.59/lib/Math/Complex.pm'>
+Math::Complex Perl package
+</ulink>
+
+This documentation is more about the complex mathematics, but also a
+bit about related Perl examles.</para>
+
+
+
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+
+
+
+<refsect2 id='libfiles'><title>libfiles</title>
+
+
+<para><emphasis remap='I'>libfiles</emphasis>
+are file written in
+<emphasis remap='I'>ideal</emphasis>.
+
+Such a file can be included into a roff file with
+<emphasis remap='I'>ideal parts</emphasis>
+by the ideal command
+<emphasis remap='B'>...libfile</emphasis>.
+
+A
+<emphasis remap='I'>libfile</emphasis>
+can also serve as an example.</para>
+
+
+
+<para>With the installation, the available
+<emphasis remap='I'>libfiles</emphasis>
+will get into
+<emphasis remap='B'>@DATASUBDIR@/ideal/libfiles</emphasis></para>
+
+
+
+</refsect2>
+
+<refsect2 id='examples'><title>Examples</title>
+
+
+<para>Some
+<emphasis remap='I'>roff</emphasis>
+files with included
+<emphasis remap='I'>ideal parts</emphasis>
+will be stored at the installation into
+<emphasis remap='B'>@EXAMPLEDIR@/ideal</emphasis>.</para>
+
+
+
+</refsect2>
+
+<refsect2 id='manpages'><title>Man-Pages</title>
+
+
+<variablelist remap='TP'>
+ <varlistentry>
+ <term><emphasis remap='B'>gideal</emphasis>(@MAN1EXT@)</term>
+ <listitem>
+<para>for information about the
+<emphasis remap='I'>ideal</emphasis>
+preprocessor in
+<emphasis remap='I'>groff</emphasis>.</para>
+
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap='B'>groff</emphasis>(@MAN1EXT@),</term>
+ <term><emphasis remap='B'>groff</emphasis>(@MAN7EXT@),</term>
+ <term><emphasis remap='B'>grog</emphasis>(@MAN1EXT@),</term>
+ <term><emphasis remap='B'>pic</emphasis>(@MAN1EXT@),</term>
+ <term><emphasis remap='B'>gpic</emphasis>(@MAN1EXT@),</term>
+ <term>Information about the</term>
+ <listitem>
+<para><emphasis remap='I'>groff</emphasis>
+system.</para>
+
+
+
+ </listitem>
+ </varlistentry>
+</variablelist>
+</refsect2>
+
+<refsect2 id='documentation_and_articles'><title>Documentation and
Articles</title>
+
+
+<variablelist remap='TP'>
+ <varlistentry>
+ <term><emphasis remap='B'>Unix8 preprocessor</emphasis></term>
+ <listitem>
+<para>freely available documentation for the
+<emphasis remap='I'>ideal preprocessor</emphasis>.
+
+The
+<emphasis remap='I'>preprocessor</emphasis>
+there is called
+<emphasis remap='B'>ideal</emphasis>,
+not
+<emphasis remap='B'>gideal</emphasis>
+as in
+<emphasis remap='I'>groff</emphasis>.</para>
+
+<para><ulink url='http://man.cat-v.org/unix_8th/1/ideal'>
+</ulink></para>
+
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap='B'>ACM articles for buying</emphasis></term>
+ <listitem>
+
+ <blockquote remap='RS'>
+
+ <variablelist remap='TP'>
+ <varlistentry>
+ <term><emphasis remap='B'>p99-van_wyk.pdf.gz</emphasis></term>
+ <listitem>
+<literallayout remap='.nf'>
+A Graphics Typesetting Language
+Christopher J. Van Wyk
+</literallayout> <!-- .fi -->
+<para><ulink url='http://dl.acm.org/citation.cfm?id=806460'>
+</ulink></para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap='B'>p163-van_wyk.pdf.gz</emphasis></term>
+ <listitem>
+<literallayout remap='.nf'>
+A High-Level Language for Specifying Pictures
+Christopher J. Van Wyk
+</literallayout> <!-- .fi -->
+<para><ulink url='http://dl.acm.org/citation.cfm?id=357303'>
+</ulink></para>
+
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </blockquote> <!-- remap='RE' -->
+
+
+
+ </listitem>
+ </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 id='authors'><title>AUTHORS</title>
+
+<para>Last update: 5 Jul 2014</para>
+
+
+
+<para>This file was written by
+<ulink url='mailto:address@hidden'>
+Bernd Warken
+</ulink></para>
+
+
+
+</refsect1>
+
+<refsect1 id='copying'><title>COPYING</title>
+
+<para>Copyright © 2014</para>
+ <blockquote remap='RS'>
+<para>Free Software Foundation, Inc.
+ </para></blockquote> <!-- remap='RE' -->
+
+
+<para>This file is part of
+<emphasis remap='I'>­ideal</emphasis>,
+which is part of
+<emphasis remap='I'>­groff</emphasis>,
+a free software project.
+
+You can redistribute it and/or modify it under the terms of the
+<!-- nh -->
+GNU General Public License
+<!-- hy -->
+as published by the
+<!-- nh -->
+Free Software Foundation version 2
+<!-- hy -->
+(\f[CI]GPL2\f[R]).</para>
+
+
+<para>The license text is available in the internet at
+<ulink url='http://www.gnu.org/licenses/gpl-2.0.html'>
+</ulink></para>
+<!-- . -->
+
+
+<!-- Emacs settings -->
+
+
+<!-- Local Variables:
+mode: nroff
+End: -->
+</refsect1>
+</refentry>
+
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: gideal: new version 0.9.6; make man-pages compatible to doclifter,
Bernd Warken <=