summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/democodetools
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-09-08 03:02:02 +0000
committerNorbert Preining <norbert@preining.info>2022-09-08 03:02:02 +0000
commit13fcaca376a969f57a6a787cf479949ee2f2fc5f (patch)
tree16f7aad6ca17d3031f8c4520c30ae49635773124 /macros/latex/contrib/democodetools
parent1a08e963ba518058881d4dc03b8293919de43c97 (diff)
CTAN sync 202209080301
Diffstat (limited to 'macros/latex/contrib/democodetools')
-rw-r--r--macros/latex/contrib/democodetools/README.md124
-rw-r--r--macros/latex/contrib/democodetools/doc/democodetools.pdfbin377361 -> 377354 bytes
-rw-r--r--macros/latex/contrib/democodetools/doc/democodetools.tex32
-rw-r--r--macros/latex/contrib/democodetools/latex/democodelisting.sty32
-rw-r--r--macros/latex/contrib/democodetools/latex/democodetools.sty32
5 files changed, 119 insertions, 101 deletions
diff --git a/macros/latex/contrib/democodetools/README.md b/macros/latex/contrib/democodetools/README.md
index 5c43895db6..cf70942584 100644
--- a/macros/latex/contrib/democodetools/README.md
+++ b/macros/latex/contrib/democodetools/README.md
@@ -1,42 +1,90 @@
-%%%==============================================================================
-%% Copyright 2022 by Alceu Frigeri
-%%
-%%
-%% This work may be distributed and/or modified under the
-%% conditions of the LaTeX Project Public License, either version 1.3c
-%% of this license or (at your option) any later version.
-%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
-%% and version 1.3 or later is part of all distributions of LaTeX
-%% version 2005/12/01 or later.
-%%
-%% This work has the LPPL maintenance status "maintained".
-%%
-%% The Current Maintainer of this work is Alceu Frigeri
-%%
-%% This is version 1.0beta (2022/09/01)
-%%
-%%
-%% This work consists of the files
-%%
-%% democodelisting.sty set of macros to typeset and demonstrate LaTeX code
-%% democodetools.sty set of macros to document LaTeX packages
-%%
-%% README.md (this file) quick introduction
-%%
-%% democode.tex LaTeX documentation
-%% democode.pdf documentation in PDF form
-%%
-%%%==============================================================================
-
-This is 'yet another doc/docx/doc3' package for LaTeX code documetation (and demonstration).
+
+democodetools
+==========
+
+This is 'yet another doc/docx/doc3' package for LaTeX code documetation.
It is designed to be 'as class independent as possible',
-meaning: it makes no assumption about page layout (besides 'having a marginpar') or underline macros.
-Furthermore, it's assumed that \maketitle and the abstract environment
+no assumption about underline macros is made.
+Furthermore, it's assumed that *\maketitle* and the *abstract* environment
were modified by the underline class, so alternatives (based on the article class) are provided.
-For more details, see the documentation, democodetools.pdf (source code: democodetools.tex)
+For more details, see the documentation,
+[democodetools.pdf](http://mirrors.ctan.org/macros/latex/contrib/democodetools/doc/democodetools.pdf)
+
+--------------
+
+## Requirements
+* none besides a fairly recent LaTeX distribution as recent as 2022/06/01
+(with the new in kernel *\ProcessKeyOptions* and *\NewDocumentCommand*)
+
+## Installation
+The stable version is available at [CTAN](https://ctan.org/pkg/democodetools).
+
+## Usage
+### Stable version
+Just place
+```latex
+ \usepackage{democodetools}
+```
+
+in the preamble and compile away.
+
+
+Be aware that options might change between versions, so you have to check them manually.
+
+## More Information and documentation
+More Information can be found in the documentation; you can find a "bleeding edge" version
+at [the github page](http://github.com/alceu-frigeri/democodetools)
+
+## Contacting Author
+
+For bug reports and enhacement suggestions, the preferred way is to use
+[the project's issue page](https://github.com/alceu-frigeri/democodetools/issues).
+Please be ready to provide an example code showing the bug, if any.
+
+Please do not use the issue page for generic help on how to use the package.
+
+* git: https://github.com/alceu-frigeri/democodetools
+
+-------------
+Copyright 2022 by Alceu Frigeri
+
+ This work may be distributed and/or modified under the
+ conditions of
+
+ * The [LaTeX Project Public License](http://www.latex-project.org/lppl.txt), version 1.3c (or later), and/or
+ * The [GNU Affero General Public License](https://www.gnu.org/licenses/agpl-3.0.html), version 3 (or later)
+
+This work has the LPPL maintenance status *maintained*.
+
+The Current Maintainer of this work is Alceu Frigeri
+
+-------------
+## This work consists of the files
+
+* democodelisting.sty
+ - set of macros to typeset and demonstrate LaTeX code
+
+* democodetools.sty
+ - set of macros to document LaTeX packages
+
+* README.md (this file)
+ - quick introduction
+
+* democode.tex
+ - package documentation
+
+* democode.pdf
+ - documentation in PDF format
+
+-------------
+
+## Changelog
-The main idea is to be able to document a package/class loading it first and then this package,
-making it possible not only to document the 'syntax'
-but also to show the end result 'as is' when using that other specific class/package.
+* Version 1.0.1beta (this)
+ - readme file cleanup (switch to markdown)
+ - text files CRLF / LF 'corrected' (hopefully)
+ - copyright cleanup
+
+* Version 1.0beta
+ - Initial release by CTAN.
diff --git a/macros/latex/contrib/democodetools/doc/democodetools.pdf b/macros/latex/contrib/democodetools/doc/democodetools.pdf
index 9d55a1d615..9f6370ec21 100644
--- a/macros/latex/contrib/democodetools/doc/democodetools.pdf
+++ b/macros/latex/contrib/democodetools/doc/democodetools.pdf
Binary files differ
diff --git a/macros/latex/contrib/democodetools/doc/democodetools.tex b/macros/latex/contrib/democodetools/doc/democodetools.tex
index 41c7a271ae..cbb47a0f60 100644
--- a/macros/latex/contrib/democodetools/doc/democodetools.tex
+++ b/macros/latex/contrib/democodetools/doc/democodetools.tex
@@ -1,39 +1,29 @@
%%%==============================================================================
%% Copyright 2022 by Alceu Frigeri
%%
+%% This work may be distributed and/or modified under the conditions of
%%
-%% This work may be distributed and/or modified under the
-%% conditions of the LaTeX Project Public License, either version 1.3c
-%% of this license or (at your option) any later version.
-%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
-%% and version 1.3 or later is part of all distributions of LaTeX
-%% version 2005/12/01 or later.
+%% * The [LaTeX Project Public License](http://www.latex-project.org/lppl.txt),
+%% version 1.3c (or later), and/or
+%% * The [GNU Affero General Public License](https://www.gnu.org/licenses/agpl-3.0.html),
+%% version 3 (or later)
%%
-%% This work has the LPPL maintenance status “maintained”.
+%% This work has the LPPL maintenance status *maintained*.
%%
%% The Current Maintainer of this work is Alceu Frigeri
%%
-%% This is version 1.0beta (2022/09/01)
+%% This is version 1.0.1beta (2022/09/06)
%%
-%%
-%% This work consists of the files
-%%
-%% democodelisting.sty set of macros to typeset and demonstrate LaTeX code
-%% democodetools.sty set of macros to document LaTeX packages
-%%
-%% README.md quick introduction
-%%
-%% democodetools.tex LaTeX documentation (this file)
-%% democodetools.pdf documentation in PDF form
+%% The list of files that compose this work can be find in the README.md file at
+%% https://ctan.org/pkg/democodetools
%%
%%%==============================================================================
\makeatletter
\def\tc@tmp@packname{democodetoolsdoc}
\def\tc@tmp@altpackname{democodetoolsdoc}
\def\tc@tmp@packdesc{Demo Code Tools Documentantion}
-\def\tc@tmp@packdate{2022/09/01}
-\def\tc@tmp@packversion{1.0beta}
+\def\tc@tmp@packdate{2022/09/06}
+\def\tc@tmp@packversion{1.0.1beta}
\let\@exp\expandafter
\@exp\edef\csname\tc@tmp@altpackname version\endcsname{\tc@tmp@packversion}
\makeatother
diff --git a/macros/latex/contrib/democodetools/latex/democodelisting.sty b/macros/latex/contrib/democodetools/latex/democodelisting.sty
index 21e74cac82..4e89283690 100644
--- a/macros/latex/contrib/democodetools/latex/democodelisting.sty
+++ b/macros/latex/contrib/democodetools/latex/democodelisting.sty
@@ -1,39 +1,29 @@
%%%==============================================================================
%% Copyright 2022 by Alceu Frigeri
%%
+%% This work may be distributed and/or modified under the conditions of
%%
-%% This work may be distributed and/or modified under the
-%% conditions of the LaTeX Project Public License, either version 1.3c
-%% of this license or (at your option) any later version.
-%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
-%% and version 1.3 or later is part of all distributions of LaTeX
-%% version 2005/12/01 or later.
+%% * The [LaTeX Project Public License](http://www.latex-project.org/lppl.txt),
+%% version 1.3c (or later), and/or
+%% * The [GNU Affero General Public License](https://www.gnu.org/licenses/agpl-3.0.html),
+%% version 3 (or later)
%%
-%% This work has the LPPL maintenance status “maintained”.
+%% This work has the LPPL maintenance status *maintained*.
%%
%% The Current Maintainer of this work is Alceu Frigeri
%%
-%% This is version 1.0beta (2022/09/01)
+%% This is version 1.0.1beta (2022/09/06)
%%
-%%
-%% This work consists of the files
-%%
-%% democodelisting.sty set of macros to typeset and demonstrate LaTeX code
-%% democodetools.sty set of macros to document LaTeX packages
-%%
-%% README.md quick introduction
-%%
-%% democodetools.tex LaTeX documentation
-%% democodetools.pdf documentation in PDF form
+%% The list of files that compose this work can be find in the README.md file at
+%% https://ctan.org/pkg/democodetools
%%
%%%==============================================================================
\NeedsTeXFormat{LaTeX2e}[2022/06/01]
\def\tc@tmp@packname{democodelisting}
\def\tc@tmp@altpackname{democodelisting}
\def\tc@tmp@packdesc{Demo Code Listing}
-\def\tc@tmp@packdate{2022/09/01}
-\def\tc@tmp@packversion{1.0beta}
+\def\tc@tmp@packdate{2022/09/06}
+\def\tc@tmp@packversion{1.0.1beta}
\let\@exp\expandafter
\@exp\edef\csname\tc@tmp@altpackname version\endcsname{\tc@tmp@packversion}
\@exp\@exp\@exp\ProvidesPackage\@exp\@exp\@exp{\@exp\tc@tmp@packname\@exp}\@exp[\tc@tmp@packdate\space v\tc@tmp@packversion\space\tc@tmp@packdesc]
diff --git a/macros/latex/contrib/democodetools/latex/democodetools.sty b/macros/latex/contrib/democodetools/latex/democodetools.sty
index f5d613ee31..aa840f9832 100644
--- a/macros/latex/contrib/democodetools/latex/democodetools.sty
+++ b/macros/latex/contrib/democodetools/latex/democodetools.sty
@@ -1,39 +1,29 @@
%%%==============================================================================
%% Copyright 2022 by Alceu Frigeri
%%
+%% This work may be distributed and/or modified under the conditions of
%%
-%% This work may be distributed and/or modified under the
-%% conditions of the LaTeX Project Public License, either version 1.3c
-%% of this license or (at your option) any later version.
-%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
-%% and version 1.3 or later is part of all distributions of LaTeX
-%% version 2005/12/01 or later.
+%% * The [LaTeX Project Public License](http://www.latex-project.org/lppl.txt),
+%% version 1.3c (or later), and/or
+%% * The [GNU Affero General Public License](https://www.gnu.org/licenses/agpl-3.0.html),
+%% version 3 (or later)
%%
-%% This work has the LPPL maintenance status “maintained”.
+%% This work has the LPPL maintenance status *maintained*.
%%
%% The Current Maintainer of this work is Alceu Frigeri
%%
-%% This is version 1.0beta (2022/09/01)
+%% This is version 1.0.1beta (2022/09/06)
%%
-%%
-%% This work consists of the files
-%%
-%% democodelisting.sty set of macros to typeset and demonstrate LaTeX code
-%% democodetools.sty set of macros to document LaTeX packages
-%%
-%% README.md quick introduction
-%%
-%% democodetools.tex LaTeX documentation
-%% democodetools.pdf documentation in PDF form
+%% The list of files that compose this work can be find in the README.md file at
+%% https://ctan.org/pkg/democodetools
%%
%%%==============================================================================
\NeedsTeXFormat{LaTeX2e}[2022/06/01]
\def\tc@tmp@packname{democodetools}
\def\tc@tmp@altpackname{democodetools}
\def\tc@tmp@packdesc{Demo Code Tools}
-\def\tc@tmp@packdate{2022/09/01}
-\def\tc@tmp@packversion{1.0beta}
+\def\tc@tmp@packdate{2022/09/06}
+\def\tc@tmp@packversion{1.0.1beta}
\let\@exp\expandafter
\@exp\edef\csname\tc@tmp@altpackname version\endcsname{\tc@tmp@packversion}
\@exp\@exp\@exp\ProvidesPackage\@exp\@exp\@exp{\@exp\tc@tmp@packname\@exp}\@exp[\tc@tmp@packdate\space v\tc@tmp@packversion\space\tc@tmp@packdesc]