summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/clefval
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-07-29 21:33:43 +0000
committerKarl Berry <karl@freefriends.org>2020-07-29 21:33:43 +0000
commitba9765989cdf7729cd58417d41092eeb6f152eaa (patch)
tree5f8f7272cbd251b8d4caac788a8565c216944a15 /Master/texmf-dist/doc/latex/clefval
parentbcc14926db4eaff495f6ba1336bdf674c54bbdb1 (diff)
clefval (29jul20)
git-svn-id: svn://tug.org/texlive/trunk@55985 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/clefval')
-rw-r--r--Master/texmf-dist/doc/latex/clefval/Changements8
-rw-r--r--Master/texmf-dist/doc/latex/clefval/Changes8
-rw-r--r--Master/texmf-dist/doc/latex/clefval/LISEZMOI35
-rw-r--r--Master/texmf-dist/doc/latex/clefval/LISEZMOI.md42
-rw-r--r--Master/texmf-dist/doc/latex/clefval/MANIFEST.md73
-rw-r--r--Master/texmf-dist/doc/latex/clefval/README31
-rw-r--r--Master/texmf-dist/doc/latex/clefval/README.md41
-rw-r--r--Master/texmf-dist/doc/latex/clefval/clefval.pdfbin174839 -> 477240 bytes
-rw-r--r--Master/texmf-dist/doc/latex/clefval/example-utf8.pdfbin0 -> 57793 bytes
-rw-r--r--Master/texmf-dist/doc/latex/clefval/example-utf8.tex101
-rw-r--r--Master/texmf-dist/doc/latex/clefval/example.pdfbin92516 -> 157812 bytes
-rw-r--r--Master/texmf-dist/doc/latex/clefval/example.tex18
-rw-r--r--Master/texmf-dist/doc/latex/clefval/exemple.pdfbin95184 -> 158520 bytes
-rw-r--r--Master/texmf-dist/doc/latex/clefval/exemple.tex17
14 files changed, 289 insertions, 85 deletions
diff --git a/Master/texmf-dist/doc/latex/clefval/Changements b/Master/texmf-dist/doc/latex/clefval/Changements
deleted file mode 100644
index ab87566fecf..00000000000
--- a/Master/texmf-dist/doc/latex/clefval/Changements
+++ /dev/null
@@ -1,8 +0,0 @@
-CLEFVAL
-
-Version 0 - 2004-05-22
-Premire version publique
-
---
-Le \TeX nicien de surface
-Yvon.Henel@wanadoo.fr \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/clefval/Changes b/Master/texmf-dist/doc/latex/clefval/Changes
deleted file mode 100644
index 0cfc923e99e..00000000000
--- a/Master/texmf-dist/doc/latex/clefval/Changes
+++ /dev/null
@@ -1,8 +0,0 @@
-CLEFVAL
-
-Version 0 - 2004-05-22
-First public version
-
---
-Le \TeX nicien de surface
-Yvon.Henel@wanadoo.fr \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/clefval/LISEZMOI b/Master/texmf-dist/doc/latex/clefval/LISEZMOI
deleted file mode 100644
index f6e77551c7e..00000000000
--- a/Master/texmf-dist/doc/latex/clefval/LISEZMOI
+++ /dev/null
@@ -1,35 +0,0 @@
-CLEFVAL 0 2004-05-22
-
-LISEZMOI % ce fichier
-README
-Changes
-Makefile
-clefval.dtx
-clefval.pdf % documentation bilingue
-clefval.ins % produit le module avec les messages en anglais
-fra-cleval.ins % produit le module avec les messages en franais
-exemple.tex % un exemple d'utilisation de engpron et clefval
-exemple.pdf %
-example.tex % la version anglaise du document prcdent
-example.pdf %
-
-clefval.xml
-
-
-clefval.sty, deux macros \TheKey et \TheValue pour dfinir puis
-utiliser des paires clef/valeur. Ce module fournit une sorte de
- hashage du pauvre ;-)
-
-
-Pour produire le fichier clefval.sty,
-avec les messages en franais, lancer :
-
-latex fra-clefval.ins
-
-Sous *nix, on peut utiliser le Makefile fourni,
-make help
-pour obtenir de l'aide.
-
---
-Le \TeX nicien de surface
-Yvon.Henel@wanadoo.fr
diff --git a/Master/texmf-dist/doc/latex/clefval/LISEZMOI.md b/Master/texmf-dist/doc/latex/clefval/LISEZMOI.md
new file mode 100644
index 00000000000..ec6e67d603f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/clefval/LISEZMOI.md
@@ -0,0 +1,42 @@
+<!-- Time-stamp: <2020-07-29 14:27:40 administrateur> -->
+<!-- Création : 2020-07-28T17:22:37+0200 -->
+
+# clefval
+
+Auteurs : Yvon Henel, alias Le TeXnicien de surface
+([contact](le.texnicien.de.surface@yvon-henel.fr))
+et Josselin Noirel.
+
+## LICENCE
+
+Le contenu de cette archive est placé sous la « LaTeX Project Public
+License » version 1.3c ou postérieure.
+
+Voir https://www.latex-project.org/lppl.txt pour la licence.
+
+© 2020 Yvon Henel (Le TeXnicien de surface)
+
+## Description de l’extension
+
+`clefval.sty` fournit deux macros `\TheKey` et `\TheValue` pour
+définir puis utiliser des paires clef/valeur. Ce module fournit une
+sorte de « hashage » du pauvre ;-)
+
+### Exemples fournis
+
+ * **example.pdf** depuis <kbd>example.tex</kbd>, version anglaise du suivant ;
+ * **exemple.pdf** depuis <kbd>exemple.tex</kbd> : fichier
+ *historique* codé en 8bit utilisant les extensions `engpron` et `clefval` ;
+ * **example-utf8.pdf** depuis <kbd>example-utf8.tex</kbd> avec <kbd>pdflatex</kbd>. Le
+ source peut être compilé avec <kbd>lualatex</kbd> ou <kbd>xelatex</kbd>. Les
+ pdf-s ainsi créés contiendront un texte supplémentaire car <kbd>pdflatex</kbd>
+ ne peut pas, par défaut, utiliser une clé écrite en cyrillique.
+
+
+## Historique
+
+Version 0.1 — 2020-07-27 — adaptation aux sources codés en utf-8
+
+Version 0 — 2004-05-22 — première version publique
+
+
diff --git a/Master/texmf-dist/doc/latex/clefval/MANIFEST.md b/Master/texmf-dist/doc/latex/clefval/MANIFEST.md
new file mode 100644
index 00000000000..aa9d4c6e1e9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/clefval/MANIFEST.md
@@ -0,0 +1,73 @@
+# Manifest for clefval
+
+This file is a listing of all files considered to be part of this package.
+It is automatically generated with `texlua build.lua manifest`.
+
+
+## Repository manifest
+
+The following groups list the files included in the development repository of the package.
+Files listed with a ‘†’ marker are included in the TDS but not CTAN files, and files listed
+with ‘‡’ are included in both.
+
+### Source files
+
+These are source files for a number of purposes, including the `unpack` process which
+generates the installation files of the package. Additional files included here will also
+be installed for processing such as testing.
+
+* clefval.dtx
+* clefval.ins
+
+### Typeset documentation source files
+
+These files are typeset using LaTeX to produce the PDF documentation for the package.
+
+* clefval.dtx
+* example-utf8.tex
+* example.tex
+* exemple.tex
+
+### Documentation files
+
+These files form part of the documentation but are not typeset. Generally they will be
+additional input files for the typeset documentation files listed above.
+
+* LISEZMOI.md
+* README.md
+
+### Text files
+
+Plain text files included as documentation or metadata.
+
+* LISEZMOI.md
+* MANIFEST.md
+* README.md
+
+### Derived files
+
+The files created by ‘unpacking’ the package sources. This typically includes
+`.sty` and `.cls` files created from DocStrip `.dtx` files.
+
+* clefval.sty
+
+### Typeset documents
+
+The output files (PDF, essentially) from typesetting the various source, demo,
+etc., package files.
+
+* clefval.pdf
+* example-utf8.pdf
+* example.pdf
+* exemple.pdf
+
+
+## TDS manifest
+
+The following groups list the files included in the TeX Directory Structure used to install
+the package into a TeX distribution.
+
+
+## CTAN manifest
+
+The following group lists the files included in the CTAN package.
diff --git a/Master/texmf-dist/doc/latex/clefval/README b/Master/texmf-dist/doc/latex/clefval/README
deleted file mode 100644
index bc1fc128f42..00000000000
--- a/Master/texmf-dist/doc/latex/clefval/README
+++ /dev/null
@@ -1,31 +0,0 @@
-CLEFVAL 01 2004-05-22
-
-LISEZMOI
-README % this file
-Changes
-Makefile
-clefval.dtx
-clefval.pdf % bilingual documentation
-clefval.ins % for an English version (of the warnings) of the package
-fra-celval.ins % for a French version (of the warnings) of the package
-example.tex % an example of usage of engpron and clefval
-example.pdf %
-exemple.tex % the French version of above
-exemple.pdf %
-clefval.xml
-
-
-clefval.sty provides two macros \TheKey and \TheValue to define then
-use pairs of key/value and gives a semblance of hash.
-
-
-To produce the clefval.sty file run:
-latex clefval.ins
-
-*nix users should use the provided Makefile, run
-make help
-to obtain help.
-
---
-Le \TeX nicien de surface
-Yvon.Henel@wanadoo.fr
diff --git a/Master/texmf-dist/doc/latex/clefval/README.md b/Master/texmf-dist/doc/latex/clefval/README.md
new file mode 100644
index 00000000000..1fe7a14bee6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/clefval/README.md
@@ -0,0 +1,41 @@
+<!-- Time-stamp: <2020-07-29 14:23:06 administrateur> -->
+<!-- Création : 2020-07-28T17:22:37+0200 -->
+
+# clefval
+
+Authors: Yvon Henel, aka Le TeXnicien de surface
+([contact](le.texnicien.de.surface@yvon-henel.fr))
+and Josselin Noirel.
+
+## LICENCE
+
+This material is subject to the LaTeX Project Public License, version
+1.3c or later.
+
+See https://www.latex-project.org/lppl.txt
+for the details of that license.
+
+© 2020 Yvon Henel (Le TeXnicien de surface)
+
+## Description of the Package
+
+`clefval.sty` provides two macros `\TheKey` and `\TheValue` to define
+then use pairs of key/value and gives a semblance of hash.
+
+### Examples provided
+
+ * **example.pdf** from <kbd>example.tex</kbd>, English version of the following.
+ * **exemple.pdf** from <kbd>exemple.tex</kbd> (French): 8bit encoded
+ legacy file using package `engpron` together with `clefval`.
+ * **example-utf8.pdf** from <kbd>example-utf8.tex</kbd> with <kbd>pdflatex</kbd>. The
+ source can also be processed with <kbd>lualatex</kbd> and <kbd>xelatex</kbd>. The
+ then created pdf-s will contain an additionnal text for <kbd>pdflatex</kbd>
+ cannot by default process a key written in cyrillic alphabet.
+
+## History
+
+Version 0.1 — 2020-07-27 — adapted to utf-8 encoded source
+
+Version 0 — 2004-05-22 — first public version
+
+
diff --git a/Master/texmf-dist/doc/latex/clefval/clefval.pdf b/Master/texmf-dist/doc/latex/clefval/clefval.pdf
index f4535d63858..61e0c1c9862 100644
--- a/Master/texmf-dist/doc/latex/clefval/clefval.pdf
+++ b/Master/texmf-dist/doc/latex/clefval/clefval.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/clefval/example-utf8.pdf b/Master/texmf-dist/doc/latex/clefval/example-utf8.pdf
new file mode 100644
index 00000000000..493ee8ed6d5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/clefval/example-utf8.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/clefval/example-utf8.tex b/Master/texmf-dist/doc/latex/clefval/example-utf8.tex
new file mode 100644
index 00000000000..7e39691afc4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/clefval/example-utf8.tex
@@ -0,0 +1,101 @@
+% Time-stamp: <2020-07-29 12:47:56 administrateur>
+% Création : 2020-07-28T12:21:18+0200
+%% =========================================================================
+%% Part of the `clefval' package.
+%% Ce fichier fait partie de l'extension « clefval »
+%%
+%% 2020-07-27; v0.1
+%%
+%% Copyright (C) 2004, 2020 by Yvon Henel Le TeXnicien de surface
+%% <le.texnicien.de.surface@yvon-henel.fr>
+%%
+%% This file 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
+%% ========================================================================
+\documentclass{article}
+\usepackage{clefval}
+\usepackage{iftex}
+\usepackage[french,main=english]{babel}
+
+\ifpdftex
+\else
+\usepackage{fontspec}
+\setmainfont{DejaVu Serif}
+\setsansfont{DejaVu Sans}
+\setmonofont{DejaVu Sans Mono}
+\fi
+
+\TheKey{j}{Joe}
+\TheKey{éçà@§}{bizarre}
+\TheKey{Разбрах}{in bulgarian: Благодаря за помощта}
+
+\begin{document}
+\bgroup
+\setlength{\parindent}{0pt}
+\noindent\hrulefill
+\vspace{0.5\baselineskip}
+
+\textbf{English}
+
+Cast a glance to the source to see some examples of \textbf{clefval}
+usage.
+
+This file can be processed with \texttt{pdflatex}, \texttt{lualatex}
+or \texttt{xelatex}.
+
+\vspace{0.5\baselineskip}
+\noindent\hrulefill
+\vspace{0.5\baselineskip}
+
+\begin{otherlanguage}{french}
+ \textbf{Français}
+
+ Jetez un œil sur le source pour voir quelques exemples d'utilisation
+ de \textbf{clefval}.
+
+ On peut compiler ce document avec \texttt{pdflatex}, \texttt{lualatex}
+ ou \texttt{xelatex}.
+\end{otherlanguage}
+
+\vspace{0.5\baselineskip}
+\noindent\hrulefill
+\egroup
+
+\vspace{\baselineskip}
+
+\(\ast\)\TheKey{}{void key}%
+% without the `%' character there's a spurious blank
+% sans le caractère « % » un espace superflu apparait
+\TheKey{Chip and Dale}{two anthropomorphic \emph{chipmunk} brothers}\(\ast\)
+
+\TheValue{j}
+
+\TheValue{k}
+
+\TheValue{éçà@§}
+
+\ifpdftex \else \TheValue{Разбрах} \fi
+% pdflatex doesn't know what to do with that key ;)
+% pdflatex ne sait pas quoi faire de cette clé ;)
+
+\TheValue{}
+
+\TheValue{Chip and Dale}
+
+\TheKey{$2+3=5$}{interresting equality \(2+3=5\)}
+\TheValue{$2+3=5$}
+% we can use $...$ but not \(...\) as a key
+% on peut utiliser $...$ mais pas \(...\) comme clé
+
+\end{document}
+
+%%% Local Variables:
+%%% coding: utf-8
+%%% TeX-engine: default
+%%% mode: latex
+%%% TeX-master: t
+%%% End:
diff --git a/Master/texmf-dist/doc/latex/clefval/example.pdf b/Master/texmf-dist/doc/latex/clefval/example.pdf
index f1ff3244852..1ed2c15c3dc 100644
--- a/Master/texmf-dist/doc/latex/clefval/example.pdf
+++ b/Master/texmf-dist/doc/latex/clefval/example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/clefval/example.tex b/Master/texmf-dist/doc/latex/clefval/example.tex
index f2dcc48838d..c24bc874f4d 100644
--- a/Master/texmf-dist/doc/latex/clefval/example.tex
+++ b/Master/texmf-dist/doc/latex/clefval/example.tex
@@ -1,4 +1,17 @@
-% -*- mode: LaTeX; coding: iso-8859-15 -*-
+%% Part of the `clefval' package.
+%%
+%% 2020-07-27; v0.1
+%%
+%% Copyright (C) 2004, 2020 by Yvon Henel Le TeXnicien de surface
+%% <le.texnicien.de.surface@yvon-henel.fr>
+%%
+%% This file 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
+%% ========================================================================
\documentclass[a4paper,10pt]{article}
\usepackage[latin9]{inputenc}
\usepackage[T1]{fontenc}
@@ -88,7 +101,8 @@ Content of the \texttt{aux} file (extract) :
\vspace*{\stretch{1}}
\end{document}
-%%% Local Variables:
+%%% Local Variables:
+%%% coding: iso-8859-15
%%% mode: latex
%%% TeX-master: t
%%% End:
diff --git a/Master/texmf-dist/doc/latex/clefval/exemple.pdf b/Master/texmf-dist/doc/latex/clefval/exemple.pdf
index 27a8f27f955..a605643b70b 100644
--- a/Master/texmf-dist/doc/latex/clefval/exemple.pdf
+++ b/Master/texmf-dist/doc/latex/clefval/exemple.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/clefval/exemple.tex b/Master/texmf-dist/doc/latex/clefval/exemple.tex
index 11d24c5a8d9..6159784d35d 100644
--- a/Master/texmf-dist/doc/latex/clefval/exemple.tex
+++ b/Master/texmf-dist/doc/latex/clefval/exemple.tex
@@ -1,4 +1,18 @@
-% -*- mode: LaTeX; coding: iso-8859-15 -*-
+%% Part of the `clefval' package.
+%% Ce fichier fait partie de l'extension clefval
+%%
+%% 2020-07-27; v0.1
+%%
+%% Copyright (C) 2004, 2020 by Yvon Henel Le TeXnicien de surface
+%% <le.texnicien.de.surface@yvon-henel.fr>
+%%
+%% This file 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
+%% ========================================================================
\documentclass[a4paper,10pt]{article}
\usepackage[latin9]{inputenc}
\usepackage[T1]{fontenc}
@@ -92,6 +106,7 @@ Contenu du fichier \texttt{aux} (extrait) :
\end{document}
%%% Local Variables:
+%%% coding: iso-8859-15
%%% mode: latex
%%% TeX-master: t
%%% End: