Hello community,
here is the log from the commit of package yodl for openSUSE:Factory checked in
at 2017-05-20 10:06:25
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/yodl (Old)
and /work/SRC/openSUSE:Factory/.yodl.new (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "yodl"
Sat May 20 10:06:25 2017 rev:28 rq:494003 version:3.08.02
Changes:
--------
--- /work/SRC/openSUSE:Factory/yodl/yodl.changes 2017-02-14
00:38:16.671986287 +0100
+++ /work/SRC/openSUSE:Factory/.yodl.new/yodl.changes 2017-05-20
10:06:28.264856964 +0200
@@ -1,0 +2,12 @@
+Wed May 10 07:14:14 UTC 2017 - mplus...@suse.com
+
+- Update to version 3.08.02:
+ * Reorganized the yodl-manpage macro (macros/rawmacros/manpage.raw):
+ + man-pages can now be converted to roff, html, and plain text
+ format.
+ + References to the todl manual page format in Yodl's user
+ guide and man-pages were updated accordingly.
+ * The reorganization also fixes a bug in the manpage html
+ conversion.
+
+-------------------------------------------------------------------
Old:
----
3.08.01.tar.gz
New:
----
3.08.02.tar.gz
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ yodl.spec ++++++
--- /var/tmp/diff_new_pack.Gv2kSn/_old 2017-05-20 10:06:28.772785193 +0200
+++ /var/tmp/diff_new_pack.Gv2kSn/_new 2017-05-20 10:06:28.772785193 +0200
@@ -17,7 +17,7 @@
Name: yodl
-Version: 3.08.01
+Version: 3.08.02
Release: 0
Summary: Yet One-other Document Language
License: GPL-3.0
@@ -82,10 +82,28 @@
%defattr(-,root,root)
%doc yodl/AUTHORS.txt yodl/changelog yodl/README.* yodl/CHANGES
%doc %{_docdir}/%{name}/
-%{_bindir}/*
+%{_bindir}/yodl
+%{_bindir}/yodl2html
+%{_bindir}/yodl2latex
+%{_bindir}/yodl2man
+%{_bindir}/yodl2ms
+%{_bindir}/yodl2sgml
+%{_bindir}/yodl2txt
+%{_bindir}/yodl2whatever
+%{_bindir}/yodl2xml
+%{_bindir}/yodlpost
+%{_bindir}/yodlstriproff
+%{_bindir}/yodlverbinsert
%dir %{_datadir}/%{name}
%{_datadir}/%{name}/*
-%{_mandir}/man1/*
-%{_mandir}/man7/*
+%{_mandir}/man1/yodl.1%{ext_man}
+%{_mandir}/man1/yodlconverters.1%{ext_man}
+%{_mandir}/man1/yodlpost.1%{ext_man}
+%{_mandir}/man1/yodlstriproff.1%{ext_man}
+%{_mandir}/man1/yodlverbinsert.1%{ext_man}
+%{_mandir}/man7/yodlbuiltins.7%{ext_man}
+%{_mandir}/man7/yodlletter.7%{ext_man}
+%{_mandir}/man7/yodlmacros.7%{ext_man}
+%{_mandir}/man7/yodlmanpage.7%{ext_man}
%changelog
++++++ 3.08.01.tar.gz -> 3.08.02.tar.gz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/yodl-3.08.01/yodl/VERSION
new/yodl-3.08.02/yodl/VERSION
--- old/yodl-3.08.01/yodl/VERSION 2016-05-07 17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/VERSION 2017-01-29 14:20:10.000000000 +0100
@@ -1,2 +1,2 @@
-#define VERSION "3.08.01"
-#define YEARS "1996-2016"
+#define VERSION "3.08.02"
+#define YEARS "1996-2017"
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/yodl-3.08.01/yodl/changelog
new/yodl-3.08.02/yodl/changelog
--- old/yodl-3.08.01/yodl/changelog 2016-05-07 17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/changelog 2017-01-29 14:20:10.000000000 +0100
@@ -1,3 +1,16 @@
+yodl (3.08.02)
+
+ * Reorganized the yodl-manpage macro (macros/rawmacros/manpage.raw):
+ man-pages can now be converted to roff, html, and plain text format.
+ References to the todl manual page format in Yodl's user guide and
+ man-pages were updated accordingly.
+
+ * The reorganization also fixes a bug in the manpage html conversion, due to
+ which manpages started with three document opening sections, and weren't
+ properly terminated by </body></html> markups.
+
+ -- Frank B. Brokken <f.b.brok...@rug.nl> Sun, 29 Jan 2017 13:27:26 +0100
+
yodl (3.08.01)
* The multiple options handling bug emerged in another context (zsh
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/yodl-3.08.01/yodl/macros/rawmacros/latexdocumentclass.raw
new/yodl-3.08.02/yodl/macros/rawmacros/latexdocumentclass.raw
--- old/yodl-3.08.01/yodl/macros/rawmacros/latexdocumentclass.raw
2016-05-07 17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/macros/rawmacros/latexdocumentclass.raw
2017-01-29 14:20:10.000000000 +0100
@@ -2,7 +2,7 @@
macro(latexdocumentclass(class)) (Forces the LaTeX
tt(\documentclass{...}) setting to tt(class). Normally the class is
defined by the macros tt(article), tt(report) or tt(book). This macro
-is an escape route incase you need to specify your own document class
+is an escape route in case you need to specify your own document class
for LaTeX. This option is a em(modifier) and must
appear em(before) the tt(article), tt(report) or tt(book) macros.)
<>
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/yodl-3.08.01/yodl/macros/rawmacros/manpage.raw
new/yodl-3.08.02/yodl/macros/rawmacros/manpage.raw
--- old/yodl-3.08.01/yodl/macros/rawmacros/manpage.raw 2016-05-07
17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/macros/rawmacros/manpage.raw 2017-01-29
14:20:10.000000000 +0100
@@ -11,7 +11,8 @@
tt(manpageseealso), tt(manpagediagnostics), tt(manpagebugs),
tt(manpageauthor). Optional extra sections can be added with
tt(manpagesection). Standard manpageframes for several manpagesections
-are provided in tt(/usr/local/share/yodl/manframes).)
+are provided in tt(/usr/local/share/yodl/manframes). YODL manual pages can be
+converted to tt(groff, html), or plain ascii text formats.)
<>
DEFINEMACRO(manpage)(5)(\
@@ -19,41 +20,19 @@
XXstartdocument(article)\
ATEXIT(XXcheckmanpage())\
ATEXIT(INTERNALINDEX(copy))\
-<html xml>
- XXsetdocumentheader(ARG1)(ARG4)(ARG3)\
-<latex>
- NOTRANS(\
- \pagestyle{myheadings}\
- \markright{ARG1(ARG2)\
- \hfill \
- ARG3 \
- \hfill \
- ARG1(ARG2) \ \ }\
- )\
-<>
- XXsetdocumentheader()()()\
-<latex>
- NOTRANS(\begin{description})\
- XXnl()\
- ATEXIT(\
- NOTRANS(\
- \end{description}\
- )\
- )\
-<texinfo>
- XXsetdocumentheader(ARG1)(ARG4)(ARG3)\
<man>
XXroffcmd(.TH)(NOTRANS(")ARG1+NOTRANS(") NOTRANS(")ARG2+NOTRANS(") \
NOTRANS(")ARG3+NOTRANS(") NOTRANS(")ARG4+NOTRANS(") \
NOTRANS(")ARG5+NOTRANS("))()()\
+<html>
+ ATEXIT(INTERNALINDEX(htmldone))\
+ XXsetdocumentheader(ARG1(ARG2))(ARG5+nl()(ARG4))(ARG3)\
+<txt>
+ XXsetdocumentheader(ARG1(ARG2))(ARG5+nl()(ARG4))(ARG3)\
<else>
- XXsetdocumentheader(ARG1(ARG2))(ARG4 ARG5)(ARG3)\
+ ERROR(man-page conversions only for yodl2man and yodl2html)
<>
)
-
-
-
-
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/yodl-3.08.01/yodl/macros/rawmacros/setmanalign.raw
new/yodl-3.08.02/yodl/macros/rawmacros/setmanalign.raw
--- old/yodl-3.08.01/yodl/macros/rawmacros/setmanalign.raw 2016-05-07
17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/macros/rawmacros/setmanalign.raw 2017-01-29
14:20:10.000000000 +0100
@@ -6,7 +6,7 @@
are columns in the table. Furthermore, tt(s) can be used to indicate that the
column to its left is combined (spans into) the current column. Use this
specification when cells spanning multiple columns are defined. Each row in a
-table which must be convertable to a manpage may contain a separate
+table which must be convertible to a manpage may contain a separate
tt(setmanalign()) call. Note that neither tt(rowline) nor tt(columnline)
requires tt(setmanalign()) specifications, as these macros define rows by
themselves. It is the responsibility of the author to ensure that the number
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/yodl-3.08.01/yodl/man/yodlmanpage.in
new/yodl-3.08.02/yodl/man/yodlmanpage.in
--- old/yodl-3.08.01/yodl/man/yodlmanpage.in 2016-05-07 17:31:57.000000000
+0200
+++ new/yodl-3.08.02/yodl/man/yodlmanpage.in 2017-01-29 14:20:10.000000000
+0100
@@ -20,9 +20,13 @@
manpagedescription()
This manual page briefly describes the bf(manpage) document type of the
- YOLD document language. This document type is specific enough that it
+ bf(Yodl) document language. This document type is specific enough that it
warrants a separate manpage.
+ bf(Yodl) mapage documents can be converted to tt(groff) documents (using
+ tt(yodl2man)), to tt(html) documents (using tt(yodl2html)), or to plain
+ ascii text documents (using tt(yodl2txt)).
+
bf(manpage) documents do not use the `standard' sectioning commands (e.g.,
bf(sect)() and bf(subsect)()), but have specific bf(manpage...)() macros.
You can however use (and are encouraged to..) other `normal' macros, such
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/yodl-3.08.01/yodl/manual/yo/macros/doctypes.yo
new/yodl-3.08.02/yodl/manual/yo/macros/doctypes.yo
--- old/yodl-3.08.01/yodl/manual/yo/macros/doctypes.yo 2016-05-07
17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/manual/yo/macros/doctypes.yo 2017-01-29
14:20:10.000000000 +0100
@@ -1,11 +1,11 @@
As distributed, Yodl supports four document types: em(article, report,
-book) and the em(manual) page. Note that document types have nothing in common
-with output formats; a book can be converted to each of the output formats,
-and a manual page can be converted to a tt(.dvi) file. Nevertheless, some
-formats are particularly usefule for some document types. A book converted to
-the tt(man) output format to be processed later with tt(groff) won't look too
-good. Its looks would greatly improve when the document would be converted to
-ASCII using the tt(ms) output format.
+book) and the em(manual) page. Note that document types are essentially
+unrelated to output formats; a book can be converted to each of the output
+formats, and a manual page can be converted to a tt(.html) file. Nevertheless,
+some formats are particularly usefule for some document types. A book
+converted to the tt(man) output format to be processed later with tt(groff)
+won't look too good. Its looks would greatly improve when the document would
+be converted to ASCII using the tt(ms) output format.
Following the preamble and the definition of specialized macros symbols and
counters, documents start by specifying the document type. The available
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/yodl-3.08.01/yodl/manual/yo/macros/manpage.yo
new/yodl-3.08.02/yodl/manual/yo/macros/manpage.yo
--- old/yodl-3.08.01/yodl/manual/yo/macros/manpage.yo 2016-05-07
17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/manual/yo/macros/manpage.yo 2017-01-29
14:20:10.000000000 +0100
@@ -1,6 +1,9 @@
The em(manpage) document type was implemented to simplify the construction of
-Unix-style manual pages. A em(manpage) document bf(must) be organized as
-follows:
+Unix-style manual pages. YODL mapage documents can be converted to tt(groff)
+documents (using tt(yodl2man)), to tt(html) documents (using tt(yodl2html)), or
+to plain ascii text documents (using tt(yodl2txt)).
+
+A em(manpage) document bf(must) be organized as follows:
enumeration(
it() The manual page itself is defined, using the macro
verb(\
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/yodl-3.08.01/yodl/manual/yo/userguide/builtin/fputs.yo
new/yodl-3.08.02/yodl/manual/yo/userguide/builtin/fputs.yo
--- old/yodl-3.08.01/yodl/manual/yo/userguide/builtin/fputs.yo 2016-05-07
17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/manual/yo/userguide/builtin/fputs.yo 2017-01-29
14:20:10.000000000 +0100
@@ -1,7 +1,7 @@
-The function tt(FPUTS) expects two arguments: the first argment is information
-to be appended to a file, whose name is given as the second argument. The
-first argument is processed by Yodl before it is appended to the requested
-filename, so it may contain macro calls.
+The function tt(FPUTS) expects two arguments: the first argument is
+information to be appended to a file, whose name is given as the second
+argument. The first argument is processed by Yodl before it is appended to the
+requested filename, so it may contain macro calls.
For example, the following statement will append a countervalue to the
mentioned file:
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/yodl-3.08.01/yodl/manual/yo/userguide/builtin/subst.yo
new/yodl-3.08.02/yodl/manual/yo/userguide/builtin/subst.yo
--- old/yodl-3.08.01/yodl/manual/yo/userguide/builtin/subst.yo 2016-05-07
17:31:57.000000000 +0200
+++ new/yodl-3.08.02/yodl/manual/yo/userguide/builtin/subst.yo 2017-01-29
14:20:10.000000000 +0100
@@ -4,7 +4,7 @@
verb(
SUBST(VERSION)(1.00)
)
- YODL will transorm all occurrences of tt(VERSION) in its input into
+ YODL will transform all occurrences of tt(VERSION) in its input into
tt(1.00).
tt(SUBST) is also useful in situations where multi-character
@@ -41,14 +41,14 @@
)
Substitutions occur extremely early while YODL processes its input files. In
-order to processs its input files, YODL takes the following basic steps:
+order to process its input files, YODL takes the following steps:
enumeration(
eit() It requests input from its lexical scanner (so-called em(tokens))
eit() Its parser processes the tokens produced by the lexical scanner
eit() Its parser may send text to an output `object', which will
eventually appear in the output file generated by YODL.
)
- YODL will perform all macro substitutions in step 2, and all character
+ YODL performs all macro substitutions in step 2, and all character
table conversions in step 3. However, the lexical scanner has access to the
tt(SUBST) definitions: as soon as its lexical analyzer detects a series of
characters matching the defining sequence of a tt(SUBST) definition, it will
