From 502b428dee94827e6f7db02bd8c5d1ef7984d6aa Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 28 Apr 2011 22:37:42 +0000 Subject: changes (28apr11) git-svn-id: svn://tug.org/texlive/trunk@22239 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/changes/README | 32 +- .../doc/latex/changes/changes.english.full.pdf | Bin 148856 -> 132319 bytes .../doc/latex/changes/changes.english.short.pdf | Bin 98580 -> 97725 bytes .../doc/latex/changes/changes.ngerman.full.pdf | Bin 153501 -> 135265 bytes .../doc/latex/changes/changes.ngerman.short.pdf | Bin 103742 -> 101920 bytes .../changes/examples/changes.example.1.de.pdf | Bin 0 -> 52907 bytes .../changes/examples/changes.example.1.de.tex | 26 + .../changes/examples/changes.example.2.de.pdf | Bin 0 -> 71007 bytes .../changes/examples/changes.example.2.de.tex | 30 + .../changes/examples/changes.example.3.de.pdf | Bin 0 -> 54075 bytes .../changes/examples/changes.example.3.de.tex | 51 + .../latex/changes/examples/changes.example1.tex | 62 -- .../latex/changes/examples/changes.example2.tex | 67 -- .../latex/changes/examples/changes.example3.tex | 95 -- .../texmf-dist/scripts/changes/delcmdchanges.bash | 249 +++++ Master/texmf-dist/source/latex/changes/changes.drv | 41 +- Master/texmf-dist/source/latex/changes/changes.dtx | 1088 ++------------------ Master/texmf-dist/source/latex/changes/changes.ins | 40 +- Master/texmf-dist/tex/latex/changes/changes.sty | 55 +- 19 files changed, 537 insertions(+), 1299 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.pdf create mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.tex create mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.pdf create mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.tex create mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.pdf create mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.tex delete mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example1.tex delete mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example2.tex delete mode 100644 Master/texmf-dist/doc/latex/changes/examples/changes.example3.tex create mode 100644 Master/texmf-dist/scripts/changes/delcmdchanges.bash (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/changes/README b/Master/texmf-dist/doc/latex/changes/README index c14c3271d9f..930dd451b82 100644 --- a/Master/texmf-dist/doc/latex/changes/README +++ b/Master/texmf-dist/doc/latex/changes/README @@ -1,15 +1,17 @@ -The changes-package allows the user to manually markup changes of text, such as additions, deletions, or replacements. -Changed text is shown in a different colour; deleted text is striked out. -The package allows free defining of additional authors and their associated colour. -It also allows you to define a markup for authors or annotations. - -Das changes-Paket dient zur manuellen Markierung von geändertem Text, insbesondere Einfügungen, Löschungen und Ersetzungen. -Der geänderte Text wird farbig markiert und, bei gelöschtem Text, durchgestrichen. -Das Paket ermöglicht die freie Definition von Autoren und deren zugeordneten Farben. -Es erlaubt zusätzlich die Definition des Autor- und Anmerkungsmarkups. - -This material is subject to the LaTeX Project Public License (LPPL). -For details see changes_eng.pdf - -Dieses Paket steht unter der LaTeX Project Public License (LPPL). -Details stehen in changes.pdf +The changes-package allows the user to manually markup changes of text, such as additions, deletions, or replacements. +Changed text is shown in a different colour; deleted text is striked out. +The package allows free defining of additional authors and their associated colour. +It also allows you to define a markup for authors or annotations. + +Das changes-Paket dient zur manuellen Markierung von geändertem Text, insbesondere Einfügungen, Löschungen und Ersetzungen. +Der geänderte Text wird farbig markiert und, bei gelöschtem Text, durchgestrichen. +Das Paket ermöglicht die freie Definition von Autoren und deren zugeordneten Farben. +Es erlaubt zusätzlich die Definition des Autor- und Anmerkungsmarkups. + +Internet: http://changes.sourceforge.net/ + +This material is subject to the LaTeX Project Public License (LPPL). +For more please see the user documentation changes.english.short.pdf + +Dieses Paket steht unter der LaTeX Project Public License (LPPL). +Für Details lesen Sie bitte die Nutzerdokumentation changes.ngerman.short.pdf diff --git a/Master/texmf-dist/doc/latex/changes/changes.english.full.pdf b/Master/texmf-dist/doc/latex/changes/changes.english.full.pdf index 4f9879d0a45..aa381736ad6 100644 Binary files a/Master/texmf-dist/doc/latex/changes/changes.english.full.pdf and b/Master/texmf-dist/doc/latex/changes/changes.english.full.pdf differ diff --git a/Master/texmf-dist/doc/latex/changes/changes.english.short.pdf b/Master/texmf-dist/doc/latex/changes/changes.english.short.pdf index 570ddf59c1b..0d5147178c4 100644 Binary files a/Master/texmf-dist/doc/latex/changes/changes.english.short.pdf and b/Master/texmf-dist/doc/latex/changes/changes.english.short.pdf differ diff --git a/Master/texmf-dist/doc/latex/changes/changes.ngerman.full.pdf b/Master/texmf-dist/doc/latex/changes/changes.ngerman.full.pdf index cff9be8045d..1294d8873ab 100644 Binary files a/Master/texmf-dist/doc/latex/changes/changes.ngerman.full.pdf and b/Master/texmf-dist/doc/latex/changes/changes.ngerman.full.pdf differ diff --git a/Master/texmf-dist/doc/latex/changes/changes.ngerman.short.pdf b/Master/texmf-dist/doc/latex/changes/changes.ngerman.short.pdf index 3ff47136d28..b45b5d8a08f 100644 Binary files a/Master/texmf-dist/doc/latex/changes/changes.ngerman.short.pdf and b/Master/texmf-dist/doc/latex/changes/changes.ngerman.short.pdf differ diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.pdf b/Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.pdf new file mode 100644 index 00000000000..8a9f2e3fa7a Binary files /dev/null and b/Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.pdf differ diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.tex b/Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.tex new file mode 100644 index 00000000000..d288173cd9c --- /dev/null +++ b/Master/texmf-dist/doc/latex/changes/examples/changes.example.1.de.tex @@ -0,0 +1,26 @@ +% changes example 1 +\documentclass{article} + +% draft = Ausgabe der Änderungen +\usepackage[draft]{changes} + +\definechangesauthor{EK}{orange} + +\begin{document} + + Dieses Beispiel zeigt die Grundfunktionen. + + \listofchanges + + Dieser Text ist nicht modifiziert. + + Hier \added{f\"uge} ich Text anonym \added{ein}. + Hier \deleted{l\"osche} ich anonym Text. + Und an dieser Stelle \replaced{\"andere}{alt} ich anonym Text. + Anonyme \deleted[][Ja!]{L\"oschung} mit Anmerkung. + + Hier \added[EK]{f\"uge} ich Text als Autor "EK" \added[EK]{ein}. + Hier f\"uge ich \added[EK][Weil ich es kann.]{Text} als Autor "EK" mit Begr\"undung ein. + +\end{document} + diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.pdf b/Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.pdf new file mode 100644 index 00000000000..e245c67f47b Binary files /dev/null and b/Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.pdf differ diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.tex b/Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.tex new file mode 100644 index 00000000000..a78e7c8576e --- /dev/null +++ b/Master/texmf-dist/doc/latex/changes/examples/changes.example.2.de.tex @@ -0,0 +1,30 @@ +% changes example 2 +\documentclass[ngerman]{article} + +\usepackage{babel} +\usepackage[utf8]{inputenc} +\RequirePackage[T1]{fontenc} + +% draft = Ausgabe der Änderungen +\usepackage[draft]{changes} + +\definechangesauthor{EK}{orange} + +\begin{document} + + Dieses Beispiel zeigt die Grundfunktionen unter Einbeziehung des babel-Pakets. + + \listofchanges + + Dieser Text ist nicht modifiziert. + + Hier \added{füge} ich Text anonym \added{ein}. + Hier \deleted{lösche} ich anonym Text. + Und an dieser Stelle \replaced{ändere}{alt} ich anonym Text. + Anonyme \deleted[][Ja!]{Löschung} mit Anmerkung. + + Hier \added[EK]{füge} ich Text als Autor "`EK"' \added[EK]{ein}. + Hier füge ich \added[EK][Weil ich es kann.]{Text} als Autor "`EK"' mit Begründung ein. + +\end{document} + diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.pdf b/Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.pdf new file mode 100644 index 00000000000..aa5cc0d31c5 Binary files /dev/null and b/Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.pdf differ diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.tex b/Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.tex new file mode 100644 index 00000000000..96895fc5e60 --- /dev/null +++ b/Master/texmf-dist/doc/latex/changes/examples/changes.example.3.de.tex @@ -0,0 +1,51 @@ +% changes example 3 +\documentclass[ngerman]{article} + +\usepackage{babel} +\usepackage[utf8]{inputenc} +\RequirePackage[T1]{fontenc} + +% draft = Ausgabe der Änderungen +\usepackage[draft]{changes} + +\definechangesauthor[Ekkart Kleinod]{EK}{orange} +\definechangesauthor{Test}{green} + +\setlocextension{changes} +\setauthormarkup[left]{(#1)~--~} +\setremarkmarkup{(#2:#1)} + +\begin{document} + + Dieses Beispiel zeigt die erweiterten Funktionen. + Es setzt die Erweiterung der Hilfsdatei auf \texttt{changes}. + Ein Autorname wird angegeben. + Die Autorenmarkierung wird links gesetzt. + Sie besteht aus dem eingeklammerten Autorennamen, der durch Leerzeichen und einen Gedankenstrich von der Änderung abgesetzt ist. + Die Anmerkung wird in Klammern gesetzt, der Autorname dahinter. + + \listofchanges + + Dieser Text ist nicht modifiziert. + + Hier \added{füge} ich Text anonym \added{ein}. + Hier \deleted{lösche} ich anonym Text. + Und an dieser Stelle \replaced{ändere}{alt} ich anonym Text. + Anonyme \deleted[][Ja!]{Löschung} mit Anmerkung. + + Hier \added[EK]{füge} ich Text als Autor "`EK"' \added[EK]{ein}. + Hier füge ich \added[EK][Weil ich es kann.]{Text} als Autor "`EK"' mit Begründung ein. + + Hier \deleted[Test][Weil ich es will.]{lösche} ich Text als Autor "`Text"'. + + Test von Zeilenumbrüchen. + + \added[EK]{eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt.} + + \deleted[EK]{gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht.} + + \replaced[EK]{eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt.} + {gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht.} + +\end{document} + diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example1.tex b/Master/texmf-dist/doc/latex/changes/examples/changes.example1.tex deleted file mode 100644 index 99fc96f9254..00000000000 --- a/Master/texmf-dist/doc/latex/changes/examples/changes.example1.tex +++ /dev/null @@ -1,62 +0,0 @@ -%% -%% This is file `changes.example1.tex', -%% generated with the docstrip utility. -%% -%% The original source files were: -%% -%% changes.dtx (with options: `example:1') -%% -%% changes.dtx -%% Copyright 2007-2010 Ekkart Kleinod (ekkart@ekkart.de) -%% -%% This work may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.3 -%% of this license or 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 Ekkart Kleinod. -%% -%% This work consists of the files -%% changes.drv -%% changes.dtx -%% changes.ins -%% README -%% and the derived files -%% changes.sty -%% changes.pdf -%% changes.example1.tex -%% changes.example2.tex -%% changes.example3.tex -%% -\documentclass{article} - - % draft = Ausgabe der Änderungen -\usepackage[draft]{changes} - -\definechangesauthor{EK}{orange} - -\begin{document} - - Dieses Beispiel zeigt die rudiment\"aren Funktionen. - - \listofchanges - - Dieser Text ist nicht modifiziert. - - Hier \added{f\"uge} ich Text anonym \added{ein}. - Hier \deleted{l\"osche} ich anonym Text. - Und an dieser Stelle \replaced{\"andere}{alt} ich anonym Text. - Anonyme \deleted[][Ja!]{L\"oschung} mit Anmerkung. - - Hier \added[EK]{f\"uge} ich Text als Autor "EK" \added[EK]{ein}. - Hier f\"uge ich \added[EK][Weil ich es kann.]{Text} - als Autor "EK" mit Begr\"undung ein. - -\end{document} -%% Copyright 2007-2010 Ekkart Kleinod -%% -%% End of file `changes.example1.tex'. diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example2.tex b/Master/texmf-dist/doc/latex/changes/examples/changes.example2.tex deleted file mode 100644 index 2e31a603ed9..00000000000 --- a/Master/texmf-dist/doc/latex/changes/examples/changes.example2.tex +++ /dev/null @@ -1,67 +0,0 @@ -%% -%% This is file `changes.example2.tex', -%% generated with the docstrip utility. -%% -%% The original source files were: -%% -%% changes.dtx (with options: `example:2') -%% -%% changes.dtx -%% Copyright 2007-2010 Ekkart Kleinod (ekkart@ekkart.de) -%% -%% This work may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.3 -%% of this license or 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 Ekkart Kleinod. -%% -%% This work consists of the files -%% changes.drv -%% changes.dtx -%% changes.ins -%% README -%% and the derived files -%% changes.sty -%% changes.pdf -%% changes.example1.tex -%% changes.example2.tex -%% changes.example3.tex -%% -\documentclass[ngerman]{article} - -\usepackage{babel} -\usepackage[utf8]{inputenc} -\RequirePackage[T1]{fontenc} - - % draft = Ausgabe der Änderungen -\usepackage[draft]{changes} - -\definechangesauthor{EK}{orange} - -\begin{document} - - Dieses Beispiel zeigt die rudimentären Funktionen - unter Einbeziehung des babel-Pakets. - - \listofchanges - - Dieser Text ist nicht modifiziert. - - Hier \added{füge} ich Text anonym \added{ein}. - Hier \deleted{lösche} ich anonym Text. - Und an dieser Stelle \replaced{ändere}{alt} ich anonym Text. - Anonyme \deleted[][Ja!]{Löschung} mit Anmerkung. - - Hier \added[EK]{füge} ich Text als Autor "`EK"' \added[EK]{ein}. - Hier füge ich \added[EK][Weil ich es kann.]{Text} - als Autor "`EK"' mit Begründung ein. - -\end{document} -%% Copyright 2007-2010 Ekkart Kleinod -%% -%% End of file `changes.example2.tex'. diff --git a/Master/texmf-dist/doc/latex/changes/examples/changes.example3.tex b/Master/texmf-dist/doc/latex/changes/examples/changes.example3.tex deleted file mode 100644 index 25835fd25f5..00000000000 --- a/Master/texmf-dist/doc/latex/changes/examples/changes.example3.tex +++ /dev/null @@ -1,95 +0,0 @@ -%% -%% This is file `changes.example3.tex', -%% generated with the docstrip utility. -%% -%% The original source files were: -%% -%% changes.dtx (with options: `example:3') -%% -%% changes.dtx -%% Copyright 2007-2010 Ekkart Kleinod (ekkart@ekkart.de) -%% -%% This work may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.3 -%% of this license or 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 Ekkart Kleinod. -%% -%% This work consists of the files -%% changes.drv -%% changes.dtx -%% changes.ins -%% README -%% and the derived files -%% changes.sty -%% changes.pdf -%% changes.example1.tex -%% changes.example2.tex -%% changes.example3.tex -%% -\documentclass[ngerman]{article} - -\usepackage{babel} -\usepackage[utf8]{inputenc} -\RequirePackage[T1]{fontenc} - - % draft = Ausgabe der Änderungen -\usepackage[draft]{changes} - -\definechangesauthor[Ekkart Kleinod]{EK}{orange} -\definechangesauthor{Test}{green} - -\setlocextension{changes} -\setauthormarkup[left]{(#1)~--~} -\setremarkmarkup{(#2:#1)} - -\begin{document} - - Dieses Beispiel zeigt die erweiterten Funktionen. - Es setzt die Erweiterung der Hilfsdatei auf \texttt{changes}. - Ein Autorname wird angegeben. - Die Autorenmarkierung wird links gesetzt. - Sie besteht aus dem eingeklammerten Autorennamen, - der durch Leerzeichen und einen Gedankenstrich - von der Änderung abgesetzt ist. - Die Anmerkung wird in Klammern gesetzt, der Autorname dahinter. - - \listofchanges - - Dieser Text ist nicht modifiziert. - - Hier \added{füge} ich Text anonym \added{ein}. - Hier \deleted{lösche} ich anonym Text. - Und an dieser Stelle \replaced{ändere}{alt} ich anonym Text. - Anonyme \deleted[][Ja!]{Löschung} mit Anmerkung. - - Hier \added[EK]{füge} ich Text als Autor "`EK"' \added[EK]{ein}. - Hier füge ich \added[EK][Weil ich es kann.]{Text} - als Autor "`EK"' mit Begründung ein. - - Hier \deleted[Test][Weil ich es will.]{lösche} ich Text - als Autor "`Text"'. - - Test von Zeilenumbrüchen. - \added{eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt.} - \deleted{gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht.} - \replaced{eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt.} - {gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht.} - -\end{document} -%% Copyright 2007-2010 Ekkart Kleinod -%% -%% End of file `changes.example3.tex'. diff --git a/Master/texmf-dist/scripts/changes/delcmdchanges.bash b/Master/texmf-dist/scripts/changes/delcmdchanges.bash new file mode 100644 index 00000000000..6f18194ee7b --- /dev/null +++ b/Master/texmf-dist/scripts/changes/delcmdchanges.bash @@ -0,0 +1,249 @@ +#!/bin/bash + +################################################################################ +# +# Copyright (C) 2011 Silvano Chiaradonna (ISTI-CNR) +# +# Macro: delcmdchanges.bash +# +# License: +# This program is free software; you can redistribute +# it and/or modify it under the terms of the +# GNU General Public License as published by the Free +# Software Foundation; either version 2 of the License, +# or (at your option) any later version. +# +# This program is distributed in the hope that it will +# be useful, but WITHOUT ANY WARRANTY; without even the +# implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. See the GNU General Public +# License for more details. +# +# You should have received a copy of the GNU General +# Public License along with this program; if not, +# write to the Free Software Foundation, Inc., 59 +# Temple Place, Suite 330, Boston, MA 02111-1307 USA +# +# An on-line copy of the GNU General Public License can +# be downloaded from the FSF web page at: +# http://www.gnu.org/copyleft/gpl.html +# +# Version: 1.0 +# +# Purpose: +# This script deletes all changes-commands of the package changes.sty, accepting changes. If option -i is specified you will be prompted to accept or reject changes interactively. +# +# Usage: +# delcmdchanges.bash [-i] [-h] +# +# Requirements: +# linux systems +# +################################################################################ + +usage() +{ + cat << EOF +usage: $0 [options] + +This script deletes all changes-commands of the package changes.sty, accepting changes. If option -i is specified you will be prompted to accept or reject changes interactively. + +options: + -h show this message + -i interactive mode +EOF +} + +#-----------------------MAIN---------------- + +while getopts ":ih" opt; do + case $opt in + i) + imode="1" + shift + ;; + h) + usage + exit + ;; + \?) + echo "Invalid option: -$OPTARG" >&2 + usage + exit + ;; + esac +done + +if [ ! -e "$1" ]; then + echo "Input file not found: $1" >&2 + exit +fi + +INFILE="$1" +OUTFILE="$2" + +rm -f "${OUTFILE}" +touch "${OUTFILE}" + +awk -v im=${imode} -v fn=${OUTFILE} ' +# remove commands (accepting changes): +# \added[][]{} +# \deleted[][]{} +# \replaced[][]{}{} + + BEGIN { EOT = SUBSEP } + +{ line[NR] = $0 } + +END { + do { + buf0 = "" + found = 0 + added = 0 + deleted = 0 + replaced = 0 + while (!found && (c = getc()) != EOT) { # parsing commands + buf0 = buf0 c + if( match(buf0, /\\added[[:space:]]*\[[^\]]*\][[:space:]]*\[[^\]]*\][[:space:]]*{/) || + match(buf0, /\\added[[:space:]]*\[[^\]]*\][[:space:]]*{/) || + match(buf0, /\\added[[:space:]]*{/) ) { # found command \added[][]{} + added = 1 + found = 1 + balance = 1 + } else + if( match(buf0, /\\deleted[[:space:]]*\[[^\]]*\][[:space:]]*\[[^\]]*\][[:space:]]*{/) || + match(buf0, /\\deleted[[:space:]]*\[[^\]]*\][[:space:]]*{/) || + match(buf0, /\\deleted[[:space:]]*{/) ) { # found command \deleted[][]{} + deleted = 1 + found = 1 + balance = 1 + } else + if( match(buf0, /\\replaced[[:space:]]*\[[^\]]*\][[:space:]]*\[[^\]]*\][[:space:]]*{/) || + match(buf0, /\\replaced[[:space:]]*\[[^\]]*\][[:space:]]*{/) || + match(buf0, /\\replaced[[:space:]]*{/) ) { # found command \replaced[][]{}{} + replaced = 1 + found = 1 + balance = 1 + } + } + if( RLENGTH == -1 ) # command not found + pbuf0 = buf0 + else { # command found + pbuf0 = substr(buf0, 1, RSTART-1) + cmd = substr(buf0, RSTART, RLENGTH) # the command + } + printf("%s", pbuf0) >> fn # print text preceding command + if (c == EOT) + break + buf = "" + if( added ) { # command \added[][]{} + while (found && balance > 0 && (c = getc()) != EOT) # parsing + buf = buf c # + cmd = cmd buf # the command + if ( im ) { # interactive mode + printf("\nat line: %d\n%s\n", nr,cmd) + printf("Accept added text, Reject added text, Ignore or Finish accepting changes? [A|r|i|f]") + getline imoderes < "/dev/tty" + if( imoderes != "r" && imoderes != "i" ) { # accept added text + pbuf = substr(buf, 1, length(buf)-1) # remove ending curly brace "}" + printf("%s", pbuf) >> fn # print + if( imoderes == "f" ) # finish accepting changes + im = 0 # normal mode + } else + if( imoderes == "i" ) # ignore cmd + printf("%s", cmd) >> fn + } else { # accept change + pbuf = substr(buf, 1, length(buf)-1) # remove ending curly brace "}" + printf("%s", pbuf) >> fn # print + } + } # \added[][]{} + else + if( deleted ) { # command \deleted[][]{} + while (found && balance > 0 && (c = getc()) != EOT) # parsing + buf = buf c # to skip + cmd = cmd buf # the command + if ( im ) { # interactive mode + printf("\nat line: %d\n%s\n", nr,cmd) + printf("Accept to remove text, Reject deletion, Ignore or Finish accepting changes? [A|r|i|f]") + getline imoderes < "/dev/tty" + if( imoderes == "r" ) { # reject deletion + pbuf = substr(buf, 1, length(buf)-1) # remove ending curly brace "}" + printf("%s", pbuf) >> fn # print + } else + if( imoderes == "i" ) # ignore cmd + printf("%s", cmd) >> fn + else # accept changes + if( imoderes == "f" ) # finish accepting changes + im = 0 # normal mode + } # else accept changes + } # \deleted[][]{} + else + if ( replaced ) { # command \replaced[][]{}{} + while (replaced && balance > 0 && (c = getc()) != EOT) # parsing + buf = buf c # + cmd = cmd buf # the command + pbufnt = substr(buf, 1, length(buf)-1) # new text + buf = "" + skip=0 + while ( !skip && (c = getc()) != EOT ) { # skip first curly brace "{" + buf = buf c + if ( c !~ /[[:space:]]/ ) + skip = 1 + } + cmd = cmd buf # the command + if ( c != "{" ) { # found "{" + printf("\nOps! Syntax error at line %d of input file: \"%s\"\nPlease fix command \\replaced[][]{}{}: \"{\" is expected.\n\n", nr+1, cmd) + break + } + buf = "" + balance = 1 # reset balance + while (replaced && balance > 0 && (c = getc()) != EOT) # parsing + buf = buf c # + cmd = cmd buf # the command + pbufot = substr(buf, 1, length(buf)) # old text + if ( im ) { # interactive mode + printf("\nat line: %d\n%s\n", nr,cmd) + printf("Accept change, Reject change, Ignore or Finish accepting changes? [A|r|i|f]") + getline imoderes < "/dev/tty" + if( imoderes == "r" ) { # reject change + printf("%s", pbufot) >> fn # print + } else + if( imoderes == "i" ) { # ignore cmd + printf("%s", cmd) >> fn + } else { # accept change + printf("%s", pbufnt) >> fn # print + if( imoderes == "f" ) # finish accepting changes + im = 0 # normal mode + } + } else { # accept change + printf("%s", pbufnt) >> fn # print + } + } # \replaced[][]{}{} + } while(c != EOT) +} + +function getc() +{ + if (!nr) { + nr = 1 + nc = 1 + } + + if (nr > NR) + return EOT + if (nc > length(line[nr])) { + ++nr + nc = 1 + return "\n" + } + c = substr(line[nr], nc, 1) + ++nc + if (c == "{") + ++balance + else if (c == "}") + --balance + if (balance < 0) + balance = 0 + return c +} ' "${INFILE}" + diff --git a/Master/texmf-dist/source/latex/changes/changes.drv b/Master/texmf-dist/source/latex/changes/changes.drv index d4a7df3effc..fe248862132 100644 --- a/Master/texmf-dist/source/latex/changes/changes.drv +++ b/Master/texmf-dist/source/latex/changes/changes.drv @@ -38,10 +38,10 @@ } % Formatierungsbefehle -\newcommand{\paket}[1]{\textsl{#1}} -\newcommand{\option}[1]{\texttt{#1}} -\newcommand{\datei}[1]{\texttt{#1}} -\newcommand{\befehl}[1]{\texttt{\textbackslash{}#1}} +\newcommand{\chpackage}[1]{\textsl{#1}} +\newcommand{\choption}[1]{\texttt{#1}} +\newcommand{\chfile}[1]{\texttt{#1}} +\newcommand{\chcommand}[1]{\texttt{\textbackslash{}#1}} % Makroüberschriften \makeatletter @@ -57,19 +57,44 @@ } \makeatother +% language selection +\selectlanguage{ngerman} + +% catchall - english +\newif\ifENGLISH +\ENGLISHtrue + +% german +\newif\ifGERMAN +\GERMANfalse +\iflanguage{ngerman}{\GERMANtrue\ENGLISHfalse}{} +\iflanguage{german}{\GERMANtrue\ENGLISHfalse}{} + +% new language example: french +% \newif\ifFRENCH +% \FRENCHfalse +% \iflanguage{french}{\FRENCHtrue\ENGLISHfalse}{} + + +\ifENGLISH + \title{The \chpackage{changes}-package} + \subtitle{Manual change markup --- version 0.5.4} +\fi + \ifGERMAN + \title{Das \chpackage{changes}-Paket} + \subtitle{Manuelle Änderungsmarkierung -- Version 0.5.4} + \fi -\title{\iflanguage{english}{The \paket{changes}-package}{Das \paket{changes}-Paket}} -\subtitle{\iflanguage{english}{Manual change markup --- version}{Manuelle Änderungsmarkierung -- Version} 0.5.3} %$^\alpha$} \author{Ekkart Kleinod} \email{ekkart@ekkart.de} -% nur Beschreibungsteil ausgeben? +% only description part? %\OnlyDescription % Eigentliches Dokument \begin{document} - \selectlanguage{ngerman} \DocInput{changes.dtx} \end{document} + diff --git a/Master/texmf-dist/source/latex/changes/changes.dtx b/Master/texmf-dist/source/latex/changes/changes.dtx index 1aa2611afb9..8637b2a8702 100644 --- a/Master/texmf-dist/source/latex/changes/changes.dtx +++ b/Master/texmf-dist/source/latex/changes/changes.dtx @@ -1,9 +1,9 @@ -% \CheckSum{511} +% \CheckSum{442} % % \iffalse meta-comment % -% Copyright (C) 2007-2010 -% Ekkart Kleinod (ekkart@ekkart.de) +% Copyright (C) 2007-2011 +% Ekkart Kleinod (ekleinod@edgesoft.de) % -------------------------------------------------------------------------- % % This work may be distributed and/or modified under the @@ -45,727 +45,56 @@ % \changes{v0.5.1}{2007/08/27}{deleted text is striked out again using package ulem, greying didn't work} % \changes{v0.5.2}{2007/10/10}{package options for pdfcolmk, ulem, and xcolor} % \changes{v0.5.3}{2010/11/22}{use class options (final, draft) as well} +% \changes{v0.5.4}{2011/04/25}{extract user documentation; default language changed to English; script for removal of commands} % \GetFileInfo{changes.dtx} % %^^A -------------------------------------------------------------------------- -%^^A definition for multilanguage documentation -% -% \newif\ifGERMAN \GERMANfalse -% \newif\ifENGLISH \ENGLISHfalse -% \iflanguage{ngerman}{\GERMANtrue}{% -% \iflanguage{german}{\GERMANtrue}{\GERMANfalse}} -% \iflanguage{english}{\ENGLISHtrue}{\ENGLISHfalse} -% -%^^A -------------------------------------------------------------------------- % % \maketitle % % \tableofcontents % \cleardoublepage % -%^^A -- Einleitung ------------------------------------------------------------ -% -% \iflanguage{english}{ -% \section{Introduction} -% -% This package provides manual change markup. -% -% Any comments, thoughts or improvements are welcome, just send an email. -% -% If you want to see the commented package-sourcecode, please uncomment \befehl{OnlyDescription} in \datei{changes.drv} and translate the document. -% -% \begin{quote} -% \small\textsc{README:} -% The changes-package allows users to manually markup changes of text such as additions, deletions, or replacements. -% Changed text is shown in a different colour; deleted text is striked out. -% The package allows free defining of additional authors and their associated colour. -% It also allows you to define a markup for authors or annotations. -% \end{quote} -% -% As I'm not a native speaker, please feel free to report any grammatic or orthographic errors. -% }{ -% \section{Einleitung} -% -% Dieses Paket dient dazu, manuelle Änderungsmarkierung anzubieten. -% -% Ein offenes Ohr für Verbesserungsvorschläge oder Kritik habe ich per Mail immer. -% -% Diejenigen, die den kommentierten Quellcode des Pakets lesen wollen, kommentieren bitte die Anweisung \befehl{OnlyDescription} in der Datei \datei{changes.drv} aus und übersetzen diese. -% -% \begin{quote} -% \small\textsc{README:} -% Das changes-Paket dient zur manuellen Markierung von geändertem Text, insbesondere Einfügungen, Löschungen und Ersetzungen. -% Der geänderte Text wird farbig markiert und, bei gelöschtem Text, durchgestrichen. -% Das Paket ermöglicht die freie Definition von Autoren und deren zugeordneten Farben. -% Es erlaubt zusätzlich die Definition des Autor- und Anmerkungsmarkups. -% \end{quote} -% } -% -%^^A -- Nutzerschnittstelle---------------------------------------------------- -% -% \iflanguage{english}{ -% \section{User interface of the \paket{changes}-package} -% }{ -% \section{Die Benutzerschnittstelle des \paket{changes}-Pakets} -% } -% -% \iflanguage{english}{ -% For activating manual change management, address the \paket{changes}-package as follows: -% }{ -% Um die Änderungsverfolgung zu aktivieren, ist das \paket{changes}-Paket wie folgt einzubinden: -% } -% -% \befehl{usepackage\{changes\}} -% -% \iflanguage{english}{ -% Options for the package are described in \autoref{sec:options}. -% }{ -% Die Paketoptionen werden in \autoref{sec:options} erläutert. -% } -% -%^^A -- Pakete ---------------------------------------------------------------- -% -% \iflanguage{english}{ -% \subsection{Used packages} -% -% The \paket{changes}-package uses already existing packages. -% The following packages have to be installed for the \paket{changes}-package; otherwise errors may occur. -% -% You will find detailed description of the packages in their distributions. -% \begin{description} -% \item [ifthen] provides an enhanced \befehl{if}-command as well as a \texttt{while}-loop -% \item [pdfcolmk] solves the problem of coloured text and page breaks (with pdflatex) -% \item [ulem] striking out texts -% \item [xcolor] provides colourised markup of texts -% \item [xkeyval] provides options with key-value-pairs -% \end{description} -% }{ -% \subsection{Benötigte Pakete} -% -% Das \paket{changes}-Paket bindet bereits Pakete ein, die für das Paket notwendig sind. -% Die Pakete werden im folgenden kurz vorgestellt und müssen für die Nutzung des \paket{changes}-Pakets zur Verfügung stehen, sonst gibt es Fehlermeldungen. -% -% Eine genauere Beschreibung der einzelnen Pakete ist in der Dokumentation der Pakete selbst zu finden. -% \begin{description} -% \item [ifthen] stellt eine verbesserte \texttt{if}-Abfrage sowie eine \texttt{while}-Schleife zur Verfügung -% \item [pdfcolmk] löst das Problem farbigen Texts über Seitenümbrüche hinweg (bei pdflatex) -% \item [ulem] Durchstreichen von Texten -% \item [xcolor] farbige Markierung von Texten -% \item [xkeyval] Eingabe von Optionen mit Werteübergabe -% \end{description} -% } -% -%^^A -- Optionen -------------------------------------------------------------- -% -% \iflanguage{english}{ -% \subsection{Options} -% }{ -% \subsection{Optionen} -% } -% \label{sec:options} -% -% \minisec{draft} -% \iflanguage{english}{ -% The \option{draft}-option enables markup of changes. -% The list of changes is available via \befehl{listofchanges}. -% This option is the default option, if no other option is selected. -% -% The \paket{changes} package reuses the declaration of \option{draft} in \befehl{documentclass}. -% The local declaration of \option{final} overrules the declaration of \option{draft} in \befehl{documentclass}. -% }{ -% Die \option{draft}-Option bewirkt, dass alle Änderungen markiert werden. -% Die Änderungsliste kann durch \befehl{listofchanges} ausgegeben werden. -% Ohne Optionsangabe wird \option{draft} automatisch eingestellt. -% -% Die Angabe von \option{draft} in \befehl{documentclass} wird vom \paket{changes}-Paket mitgenutzt. -% Die lokale Angabe von \option{final} überstimmt die Angabe von \option{draft} in \befehl{documentclass}. -% } -% -% \befehl{usepackage[draft]\{changes\}} -% -% \minisec{final} -% -% \iflanguage{english}{ -% The \option{final}-option disables markup of changes, only the correct text will be shown. -% The list of changes is disabled, too. -% -% The \paket{changes} package reuses the declaration of \option{final} in \befehl{documentclass}. -% The local declaration of \option{draft} overrules the declaration of \option{final} in \befehl{documentclass}. -% }{ -% Die \option{final}-Option bewirkt, dass alle Änderungsmarkierungen ausgeblendet werden und nur noch der korrekte Text ausgegeben wird. -% Die Änderungsliste wird ebenfalls unterdrückt. -% -% Die Angabe von \option{final} in \befehl{documentclass} wird vom \paket{changes}-Paket mitgenutzt. -% Die lokale Angabe von \option{draft} überstimmt die Angabe von \option{final} in \befehl{documentclass}. -% } -% -% \befehl{usepackage[final]\{changes\}} -% -% \minisec{ulem} -% -% \iflanguage{english}{ -% All options for the \paket{ulem} package can be specified as parameters of the \option{ulem}-option. -% Two or more options have to be embraced in curly brackets. -% }{ -% Optionen für das \paket{ulem}-Paket können als Parameter der \option{ulem}-Option angegeben werden. -% Zwei oder mehr Optionen müssen in geschweifte Klammern gesetzt werden. -% } -% -% \befehl{usepackage[ulem=normalem]\{changes\}}\\ -% \befehl{usepackage[ulem=\{normalem,normalbf\}]\{changes\}} -% -% \minisec{xcolor} -% -% \iflanguage{english}{ -% All options for the \paket{xcolor} package can be specified as parameters of the \option{xcolor}-option. -% Two or more option have to be embraced in curly brackets. -% }{ -% Optionen für das \paket{xcolor}-Paket können als Parameter der \option{xcolor}-Option angegeben werden. -% Zwei oder mehr Optionen müssen in geschweifte Klammern gesetzt werden. -% } -% -% \befehl{usepackage[xcolor=dvipdf]\{changes\}}\\ -% \befehl{usepackage[xcolor=\{dvipdf,gray\}]\{changes\}} -% -%^^A -- Neue Befehle ---------------------------------------------------------- -% -% \iflanguage{english}{ -% \subsection{New commands} -% -% This section describes all new commands of the \paket{changes}-package. -% }{ -% \subsection{Neue Befehle} -% -% Dieser Abschnitt führt alle neuen Befehle auf und erläutert sie. -% } -% -% \iflanguage{english}{ -% \subsubsection{Change management} -% }{ -% \subsubsection{Änderungsmanagement} -% } -% -% \DescribeMacro{\added} -% \iflanguage{english}{ -% The command \befehl{added} marks new text. -% The new text is the mandatory argument for the command, thus it is written in curly braces. -% There are two optional arguments: author-id and remark. -% The author-id has to be defined using \befehl{definechangesauthor}. -% Use an empty author for an anonymous remark. -% \begin{einspiel} -% \>\befehl{added[\meta{author-id}][\meta{remark}]\{\meta{new text}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\texttt{This is \befehl{added}[EK]\{new\} text.}\\ -% \>This is \added[EK]{new} text.\\ -% \>\texttt{This is \befehl{added}[][anonymous]\{new\} text.}\\ -% \>This is \added[][anonymous]{new} text. -% \end{einspiel} -% }{ -% Der Befehl \befehl{added} markiert zugefügten Text. -% Der neue Text wird als notwendiges Argument in geschweiften Klammern übergeben. -% Optional können eine Autoren-ID sowie eine Anmerkung übergeben werden. -% Die Autoren-ID muss mit einer mit dem \befehl{definechangesauthor}-Befehl definierten ID übereinstimmen. -% Soll nur eine Anmerkung (ohne Autor) eingegeben werden, so ist statt des Autors ein leeres Argument zu übergeben. -% \begin{einspiel} -% \>\befehl{added[\meta{Autor-ID}][\meta{Anmerkung}]\{\meta{neuer Text}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\texttt{Das ist \befehl{added}[EK]\{neuer\} Text.}\\ -% \>Das ist \added[EK]{neuer} Text.\\ -% \>\texttt{Das ist \befehl{added}[][anonym]\{neuer\} Text.}\\ -% \>Das ist \added[][anonym]{neuer} Text. -% \end{einspiel} -% } -% -% \DescribeMacro{\deleted} -% \iflanguage{english}{ -% The command \befehl{deleted} marks deleted text. -% For arguments see \befehl{added}. -% \begin{einspiel} -% \>\befehl{deleted[\meta{author-id}][\meta{remark}]\{\meta{deleted text}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\texttt{This is \befehl{deleted}[][unnecessary]\{bad\} text.}\\ -% \>This is \deleted[][obsolet]{bad} text. -% \end{einspiel} -% }{ -% Der Befehl \befehl{deleted} markiert gelöschten Text. -% Argumente: siehe \befehl{added}. -% \begin{einspiel} -% \>\befehl{deleted[\meta{Autor-ID}][\meta{Anmerkung}]\{\meta{gelöschter Text}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\texttt{Das ist \befehl{deleted}[][obsolet]\{schlechter\} Text.}\\ -% \>Das ist \deleted[][obsolet]{schlechter} Text. -% \end{einspiel} -% } -% -% \DescribeMacro{\replaced} -% \iflanguage{english}{ -% The command \befehl{replaced} marks replaced text. -% Mandatory arguments are new and old text. -% For optional arguments see \befehl{added}. -% \begin{einspiel} -% \>\befehl{replaced[\meta{author-id}][\meta{remark}]\{\meta{new text}\}\{\meta{old text}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\texttt{This is \befehl{replaced}[EK]\{nice\}\{ugly\} text.}\\ -% \>This is \replaced[EK]{nice}{ugly} text. -% \end{einspiel} -% }{ -% Der Befehl \befehl{replaced} markiert geänderten Text. -% Notwendige Argumente sind der neue sowie der alte Text. -% Optionale Argumente: siehe \befehl{added}. -% \begin{einspiel} -% \>\befehl{replaced[\meta{Autor-ID}][\meta{Anmerkung}]\{\meta{neuer Text}\}\{\meta{alter Text}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\texttt{Das ist \befehl{replaced}[EK]\{schöner\}\{schlechter\} Text.}\\ -% \>Das ist \replaced[EK]{schöner}{schlechter} Text. -% \end{einspiel} -% } -% -% \DescribeMacro{\listofchanges} -% \iflanguage{english}{ -% The command \befehl{listofchanges} outputs a list of changes. -% The first \LaTeX-run creates an auxiliary file, the second run uses the data of this file. -% Therefore you need two \LaTeX-runs for an actual list of changes. -% }{ -% Der Befehl \befehl{listofchanges} gibt eine Liste der Änderungen aus. -% Im ersten \LaTeX-Lauf wird eine Hilfsdatei angelegt, deren Daten im zweiten Durchlauf eingebunden werden. -% Für eine aktuelle Liste der Änderungen sind daher zwei \LaTeX-Läufe notwendig. -% } -% \begin{einspiel} -% \>\befehl{listofchanges} -% \end{einspiel} -% -%^^A -- Nutzeranpassungen ----------------------------------------------------- -% -% \iflanguage{english}{ -% \subsubsection{User specific adaptions} -% }{ -% \subsubsection{Nutzerdefinierte Anpassungen} -% } -% -% \DescribeMacro{\definechangesauthor} -% \iflanguage{english}{ -% The command \befehl{definechangesauthor} defines a new author for changes. -% You have to define a unique author-id and a corresponding colour. -% Special characters or spaces are not allowed in the author-id. -% The name of the author can optionally be defined, it is used in the list of changes. -% \begin{einspiel} -% \>\befehl{definechangesauthor[\meta{author-name}]\{\meta{author-id}\}\{\meta{colour}\}} -% \end{einspiel} -% }{ -% Der Befehl \befehl{definechangesauthor} definiert einen neuen Autor für Änderungen. -% Es muss eine eindeutige Autor-ID und dessen Farbe angegeben werden. -% Die Autor-ID darf keine Sonder- oder Leerzeichen enthalten. -% Ein Autorenname kann optional angegeben werden, er wird in der Änderungsliste benutzt. -% \begin{einspiel} -% \>\befehl{definechangesauthor[\meta{Autor-Name}]\{\meta{Autor-ID}\}\{\meta{Farbe}\}} -% \end{einspiel} -% } -% \begin{einspiel}[true] -% \>\befehl{definechangesauthor\{EK\}\{orange\}}\\ -% \>\befehl{definechangesauthor[Ekkart Kleinod]\{EK\}\{orange\}} -% \end{einspiel} -% -% \DescribeMacro{\setlocextension} -% \iflanguage{english}{ -% The command \befehl{setlocextension} sets the extension of the auxiliary file for the list of changes. -% The default extension is "\texttt{loc}". -% In the example, the auxiliary file for "\texttt{foo.tex}" would be named named "\texttt{foo.changes}". -% }{ -% Der Befehl \befehl{setlocextension} legt das Suffix der Hilfsdatei für die Änderungsliste fest. -% Ohne andere Definition gilt das Suffix "`\texttt{loc}"'. -% Das Beispiel würde für "`\texttt{foo.tex}"' Hilfsdateien erzeugen, die "`\texttt{foo.changes}"' heißen. -% } -% \begin{einspiel} -% \>\befehl{setlocextension\{\meta{extension}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\befehl{setlocextension\{changes\}} -% \end{einspiel} -% -% \DescribeMacro{\setauthormarkup} -% \iflanguage{english}{ -% The command \befehl{setauthormarkup} sets the layout of the authormarkup in the text. -% The default markup is a superscripted author-id on the right side of the changed text. -% -% Values for position (optional): \emph{left} = left of the changes; all other values: right\\ -% Values for definition: any \LaTeX-commands, author-id can be shown using "\#1". -% }{ -% Der Befehl \befehl{setauthormarkup} legt fest, wie der Autor im Text angezeigt wird. -% Ohne andere Definition gilt, dass der Autor rechts von den Änderungen hochgestellt erscheint. -% -% Werte für Position (optional): \emph{left} = links von den Änderungen; alles andere: rechts\\ -% Werte für Definition: beliebige \LaTeX-Befehle, der Autorenname wird mit "`\#1"' gekennzeichnet. -% } -% \begin{einspiel} -% \>\befehl{setauthormarkup[\meta{position}]\{\meta{definition}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\befehl{setauthormarkup\{(\#1)\}}\\ -% \>\befehl{setauthormarkup[left]\{(\#1)\textasciitilde{}-{}-\textasciitilde{}\}}\\ -% \>\befehl{setauthormarkup\{}\befehl{marginpar\{\#1\}\}}\\ -% \>\befehl{setauthormarkup[right]\{\}} -% \end{einspiel} -% -% \DescribeMacro{\setremarkmarkup} -% \iflanguage{english}{ -% The command \befehl{setremarkmarkup} sets the layout of the remarkmarkup in the text. -% The default markup sets the remark in a footnote. -% -% Values for definition: any \LaTeX-commands, author-id can be used with "\#1", remark can be shown using "\#2". -% Using the author-id you can use the author's colour with \texttt{Changes@Color\#1}. -% }{ -% Der Befehl \befehl{setremarkmarkup} legt fest, wie die Anmerkungen im Text angezeigt werden. -% Ohne andere Definition gilt, dass die Anmerkungen als Fußnote mit farbigem Text gesetzt werden. -% -% Werte für Definition: beliebige \LaTeX-Befehle, die Autor-ID wird mit "`\#1"' benutzt, der Anmerkungstext mit "`\#2"'. -% Über die Autor-ID kann mit \texttt{Changes@Color\#1} die Farbe des Autors benutzt werden. -% } -% \begin{einspiel} -% \>\befehl{setremarkmarkup\{\meta{definition}\}} -% \end{einspiel} -% \begin{einspiel}[true] -% \>\befehl{setremarkmarkup\{(\#2:\#1)\}}\\ -% \>\befehl{setremarkmarkup\{\befehl{footnote}\{\#1:\befehl{textcolor\{Changes@Color\#1\}}\{\#2\}\}\}} -% \end{einspiel} -% -%^^A -- Versionen ------------------------------------------------------------- -% -% \StopEventually{ -% -% \iflanguage{english}{ -% \section{Authors} -% }{ -% \section{Autoren} -% } -% \label{sec:authors} -% -% \iflanguage{english}{ -% The \paket{changes} packages was written by several authors. -% The authors are (in alphabetical order): -% }{ -% Am \paket{changes}-Paket haben mehrere Autoren mitgewirkt. -% Dies sind in alphabetischer Reihenfolge: -% } -% \begin{itemize} -% \item Kleinod, Ekkart -% \item Wolter, Steve -% \end{itemize} -% -% \iflanguage{english}{ -% \section{Versions} -% }{ -% \section{Versionen} -% } -% \label{sec:versions} -% -% \iflanguage{english}{ -% \subsection{TODO/known bugs} -% -% \begin{itemize} -% \item ant-task for deleting all \paket{changes}-commands -% \item markup of figures/tables -% \item change-environments for longer text -% \item missing T1-fonts (umlauts) and \paket{inputenc} create errors -% \item maybe introducing second-class change-commands (not so important), using starred commands? -% \end{itemize} -% }{ -% \subsection{TODO/bekannte Fehler} -% -% \begin{itemize} -% \item Ant-Task zur Entfernung aller \paket{changes}-Befehle -% \item Bild/Tabellenauszeichnung -% \item Änderungsumgebungen für längere Passagen -% \item bei fehlenden T1-Fonts (Umlautkodierung) und \paket{inputenc} gibt es Fehler -% \item evtl.\ zweite Klasse von Änderungen: nicht so wichtige (extra ausblendbar), vielleicht über Stern-Variante? -% \end{itemize} -% } -% -% \subsection{Version 0.5.3} -% -% \iflanguage{english}{ -% Date: 2010/11/22 -% \begin{itemize} -% \item document options of \befehl{documentclass} are used as well (suggestion and code of Steve Wolter) -% \end{itemize} -% }{ -% Datum: 22.\,11.~2010 -% \begin{itemize} -% \item Dokumentoptionen von \befehl{documentclass} werden ebenfalls genutzt (Vorschlag und Code von Steve Wolter) -% \end{itemize} -% } -% -% \subsection{Version 0.5.2} -% -% \iflanguage{english}{ -% Date: 2007/10/10 -% \begin{itemize} -% \item package options for \paket{pdfcolmk}, \paket{ulem}, and \paket{xcolor} are passed to the packages -% \end{itemize} -% }{ -% Datum: 10.\,10.~2007 -% \begin{itemize} -% \item Paketoptionen der Pakete \paket{pdfcolmk}, \paket{ulem}, and \paket{xcolor} werden weitergeleitet -% \end{itemize} -% } -% -% \subsection{Version 0.5.1} -% -% \iflanguage{english}{ -% Date: 2007/08/27 -% \begin{itemize} -% \item deleted text is striked out again using package \paket{ulem}, greying didn't work -% \end{itemize} -% }{ -% Datum: 27.\,08.~2007 -% \begin{itemize} -% \item gelöschter Text wieder durchgestrichen, Paket \paket{ulem} funktioniert; ausgrauen hat nicht funktioniert -% \end{itemize} -% } -% -% \subsection{Version 0.5} -% -% \iflanguage{english}{ -% Date: 2007/08/26 -% \begin{itemize} -% \item no usage of package \paket{arrayjob} anymore, thus no errors using package \paket{array} -% \item switch to UTF-8-encoding -% \item no usage of package \paket{soul} anymore, thus no errors using UTF-8-encoding -% \item markup for deleted text changed to gray background, because there's no possibility to conveniently strikeout UTF-8-text -% \item new optional argument for author name -% \item coloured list of changes -% \item changed loc file format -% \item improved English documentation -% \end{itemize} -% }{ -% Datum: 26.\,08.~2007 -% \begin{itemize} -% \item keine Nutzung des \paket{arrayjob}-Pakets mehr, dadurch Fehler im Zusammenspiel mit \paket{array} behoben -% \item auf UTF-8-encoding umgestellt -% \item keine Nutzung des \paket{soul}-Pakets mehr, dadurch Fehler im Zusammenspiel UTF-8-encoding behoben -% \item gelöschter Text durch grauen Hintergrund visualisiert (es gibt bisher kein ordentliches Durchstreichen bei UTF-8-Nutzung) -% \item neues optionales Argument für Autorenname -% \item farbige Liste der Änderungen -% \item loc-Format geändert -% \item englische Doku verbessert -% \end{itemize} -% } -% -% \subsection{Version 0.4} -% -% \iflanguage{english}{ -% Date: 2007/01/24 -% \begin{itemize} -% \item included \paket{pdfcolmk} to solve problem with coloured text and page breaks -% \item extended \befehl{setremarkmarkup} with author-id for using colour in remarks -% \item remarks are by default coloured now -% \item first version uploaded to CTAN -% \end{itemize} -% }{ -% Datum: 24.\,01.~2007 -% \begin{itemize} -% \item \paket{pdfcolmk} eingebunden, um Problem mit farbigem Text bei Seitenumbrüchen zu lösen -% \item \befehl{setremarkmarkup} um Autor-ID erweitert, um Anmerkung farbig setzen zu können -% \item Anmerkungen werden in der Fußnote farbig gesetzt -% \item erste Version für das CTAN -% \end{itemize} -% } -% -% \subsection{Version 0.3} -% -% \iflanguage{english}{ -% Date: 2007/01/22 -% \begin{itemize} -% \item english user-documentation -% \item replaced \befehl{changed} with \befehl{replaced} -% \item improved \option{final}-option: no additional space -% \end{itemize} -% }{ -% Datum: 22.\,01.~2007 -% \begin{itemize} -% \item englische Nutzerdokumentation -% \item Befehl \befehl{changed} ersetzt durch \befehl{replaced} -% \item verbesserte \option{final}-Option: kein zusätzlicher Leerraum -% \end{itemize} -% } -% -% \subsection{Version 0.2} +% \input{user} % -% \iflanguage{english}{ -% Date: 2007/01/17 -% \begin{itemize} -% \item defined loc-names when missing \paket{babel}-package -% \item \befehl{setauthormarkup}, \befehl{setlocextension}, \befehl{setremarkmarkup} new -% \item generated examples -% \item inserted LPPL -% \end{itemize} -% Bugfixes -% \begin{itemize} -% \item fixed wrong \paket{ifthen}-placement -% \item fixed error in loc, always showing "added" -% \item fixed authormarkup (\befehl{if}-condition not bugfree) -% \end{itemize} -% }{ -% Datum: 17.\,01.~2007 -% \begin{itemize} -% \item Bezeichnungen auch bei fehlendem \paket{babel}-Paket eingeführt -% \item \befehl{setauthormarkup}, \befehl{setlocextension}, \befehl{setremarkmarkup} für Einstellungen -% \item Beispieldateien generiert -% \item LPPL eingefügt -% \end{itemize} -% Bugfixes -% \begin{itemize} -% \item Fehler mit \paket{ifthen}-Paketplazierung behoben -% \item bei Liste war immer "`Eingefügt"' eingestellt, behoben -% \item Autorausgabe war buggy (\befehl{if}-Abfrage nicht einwandfrei) -% \end{itemize} -% } -% -% \subsection{Version 0.1} -% -% \iflanguage{english}{ -% Date: 2007/01/16 -% \begin{itemize} -% \item initial version -% \item commands \befehl{added}, \befehl{deleted}, and \befehl{changed} -% \end{itemize} -% }{ -% Datum: 16.\,01.~2007 -% \begin{itemize} -% \item initiale Version -% \item Befehle \befehl{added}, \befehl{deleted} und \befehl{changed} -% \end{itemize} -% } -% -% \iflanguage{english}{ -% \section{Distribution, Copyright, License} -% -% Copyright 2007-2010 Ekkart Kleinod (\href{mailto:ekkart@ekkart.de}{ekkart@ekkart.de}) -% -% This work may be distributed and/or modified under the -% conditions of the \LaTeX\ Project Public License, either version~1.3 -% of this license or any later version. -% The latest version of this license is in\\ -% \url{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. +%^^A -- source code % -% This work has the LPPL maintenance status "maintained". -% The current maintainer of this work is Ekkart Kleinod. -% -% This work consists of the files -% \begin{tabbing} -% mm\=\kill -% \>\texttt{changes.drv}\\ -% \>\texttt{changes.dtx}\\ -% \>\texttt{changes.ins}\\ -% \>\texttt{README} -% \end{tabbing} -% and the derived files -% \begin{tabbing} -% mm\=\kill -% \>\texttt{changes.sty}\\ -% \>\texttt{changes.pdf}\\ -% \>\texttt{changes.example1.tex}\\ -% \>\texttt{changes.example2.tex}\\ -% \>\texttt{changes.example3.tex} -% \end{tabbing} -% }{ -% \section{Weitergabe, Copyright, Lizenz} -% -% Copyright 2007-2010 Ekkart Kleinod (\href{mailto:ekkart@ekkart.de}{ekkart@ekkart.de}) -% -% Dieses Paket darf unter der "`\LaTeX\ Project Public License"' Version~1.3 oder jeder späteren Version weitergegeben und/oder geändert werden. -% Die neueste Version dieser Lizenz steht auf\\ -% \url{http://www.latex-project.org/lppl.txt}\\ -% Version~1.3 und spätere Versionen sind Teil aller \LaTeX-Distributionen ab Version~2005/12/01. -% -% Dieses Paket besitzt den Status "`maintained"' (verwaltet). -% Der aktuelle Verwalter dieses Pakets ist Ekkart Kleinod. +% \StopEventually % -% Dieses Paket besteht aus den Dateien -% \begin{tabbing} -% mm\=\kill -% \>\texttt{changes.drv}\\ -% \>\texttt{changes.dtx}\\ -% \>\texttt{changes.ins}\\ -% \>\texttt{README} -% \end{tabbing} -% und den generierten Dateien -% \begin{tabbing} -% mm\=\kill -% \>\texttt{changes.sty}\\ -% \>\texttt{changes.pdf}\\ -% \>\texttt{changes.example1.tex}\\ -% \>\texttt{changes.example2.tex}\\ -% \>\texttt{changes.example3.tex} -% \end{tabbing} -% } -% -% } ^^A \StopEventually +% \section{The documented sourcecode} % -%^^A -- Quellcode ------------------------------------------------------------- -% -% \iflanguage{english}{ -% \section{The documented sourcecode} -% }{ -% \section{Der kommentierte Quellcode} +% \iflanguage{english}{}{ +% The sourcecode is documented in English only. +% This is intended, please do not provide translations for the text below, just corrections or improvements. % } % -% \iflanguage{english}{ -% \subsection{Package information and options} -% }{ -% \subsection{Paketinfo und Optionen} -% } +% \subsection{Package information and options} % % \begin{macrocode} %<*changes> % \end{macrocode} % -% \iflanguage{english}{ -% Set needed \LaTeX-format to \LaTeXe{}, provide name, date, version. -% Type some information to the console. -% }{ -% Zunächst legen wir die benötigte \LaTeX-Version auf \LaTeXe{} fest und geben Name, Datum und Version des Pakets zurück. -% Außerdem werden einige Ausgaben auf die Konsole gegeben. -% } +% Set needed \LaTeX-format to \LaTeXe{}, provide name, date, version. +% Type some information to the console. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{changes} -[2010/11/22 v0.5.3 changes-Paket] -\typeout{*** changes-Paket 2010/11/22 v0.5.3 ***} +[2011/04/25 v0.5.4 changes-Paket] +\typeout{*** changes-Paket 2011/04/25 v0.5.4 ***} % \end{macrocode} % -% \iflanguage{english}{ -% Package \paket{xkeyval} provides options with key-value-pairs. -% }{ -% Das Paket \paket{xkeyval} ist für die Eingabe von Optionen mit Werteübergabe zuständig. -% } +% Package \chpackage{xkeyval} provides options with key-value-pairs. % \begin{macrocode} \RequirePackage{xkeyval} % \end{macrocode} % -% \iflanguage{english}{ -% Package \paket{ifthen} provides improved \texttt{if} as well as a \texttt{while}-loop. -% }{ -% Das Paket \paket{ifthen} stellt eine verbesserte \texttt{if}-Abfrage sowie eine \texttt{while}-Schleife zur Verfügung. -% } +% Package \chpackage{ifthen} provides improved \texttt{if} as well as a \texttt{while}-loop. % \begin{macrocode} \RequirePackage{ifthen} % \end{macrocode} % -% \iflanguage{english}{ -% \minisec{Options} -% Option \option{draft}, \emph{default} -% }{ -% \minisec{Optionen} -% \option{draft}-Option, \emph{default} -% } +% \minisec{Options} +% Option \choption{draft}, \emph{default} is \texttt{true}. % \begin{macrocode} \newboolean{Changes@optiondraft} \setboolean{Changes@optiondraft}{true} @@ -775,11 +104,7 @@ } % \end{macrocode} % -% \iflanguage{english}{ -% Option \option{final} -% }{ -% \option{final}-Option -% } +% Option \choption{final}, sets \choption{draft} to \texttt{false}. % \begin{macrocode} \DeclareOptionX{final}{ \setboolean{Changes@optiondraft}{false} @@ -787,11 +112,7 @@ } % \end{macrocode} % -% \iflanguage{english}{ -% Options for package \paket{ulem} -% }{ -% Optionen für das \paket{ulem}-Paket -% } +% Options for package \chpackage{ulem} are directly passed to the package. % \begin{macrocode} \DeclareOptionX{ulem}{ \typeout{ulem-option '#1', passed to package ulem} @@ -799,11 +120,7 @@ } % \end{macrocode} % -% \iflanguage{english}{ -% Options for package \paket{xcolor} -% }{ -% Optionen für das \paket{xcolor}-Paket -% } +% Options for package \chpackage{xcolor} are directly passed to the package. % \begin{macrocode} \DeclareOptionX{xcolor}{ \typeout{xcolor-option '#1', passed to package xcolor} @@ -811,70 +128,48 @@ } % \end{macrocode} % -% \iflanguage{english}{ -% Unknown options -% }{ -% Unbekannte Optionen -% } +% Unknown options generate package warning. % \begin{macrocode} \DeclareOptionX*{ \PackageWarning{Unknown changes-option '\CurrentOption'} } % \end{macrocode} % -% \iflanguage{english}{ -% Execute processing of options. -% }{ -% Ausführung des Optionenbearbeitens. -% } +% Process the options. % \begin{macrocode} \ProcessOptionsX*\relax % \end{macrocode} % -% \iflanguage{english}{ -% Package \paket{xcolor} provides coloured text. -% }{ -% Das Paket \paket{xcolor} stellt die Färbung von Texten zur Verfügung. -% } +% Package \chpackage{xcolor} provides coloured text. % \begin{macrocode} \RequirePackage{xcolor} % \end{macrocode} % -% \iflanguage{english}{ -% Package \paket{pdfcolmk} solves the problem of coloured text and page breaks (has to be loaded after \paket{xcolor}). -% }{ -% Das Paket \paket{pdfcolmk} löst das Problem farbigen Texts über Seitenumbrüche hinweg (muss nach \paket{xcolor} geladen werden). -% } +% Package \chpackage{pdfcolmk} solves the problem of coloured text and page breaks (has to be loaded after \chpackage{xcolor}). % \begin{macrocode} \RequirePackage{pdfcolmk} % \end{macrocode} % -% \iflanguage{english}{ -% Package \paket{ulem} provides commands for striking out text. -% }{ -% Das Paket \paket{ulem} stellt Kommandos für das Durchstreichen von Text zur Verfügung. -% } +% Package \chpackage{ulem} provides commands for striking out text. % \begin{macrocode} \RequirePackage{ulem} % \end{macrocode} % -% \iflanguage{english}{ -% \subsection{Definitions} -% Names. -% }{ -% \subsection{Einstellungen} -% Bezeichnungen. -% } +% \subsection{Definitions} +% +% Declaration of language dependent names and identifiers. +% The check for \chcommand{addto} is a check for the \chpackage{babel} package. +% If the babel package is not loaded, the default language is English, in order to use an own language, the user has to redefine the variables. % \begin{macrocode} \ifthenelse{\isundefined{\addto}} { - \def\listchangesname{\"Anderungen} - \def\changesaddname{Eingef\"ugt} - \def\changesdeletename{Gel\"oscht} - \def\changesreplacename{Ersetzt} - \def\changesauthorname{Autor} - \def\changesanonymousname{Anonym} - \def\changesnoloc{\"Anderungsliste erst nach dem n\"achsten Durchlauf verf\"ugbar.} + \def\listchangesname{Changes} + \def\changesaddname{Added} + \def\changesdeletename{Deleted} + \def\changesreplacename{Replaced} + \def\changesauthorname{Author} + \def\changesanonymousname{anonymous} + \def\changesnoloc{List of changes is available after the next \LaTeX\ run.} }{ \addto\captionsngerman{\def\listchangesname{\"Anderungen}} \addto\captionsgerman{\def\listchangesname{\"Anderungen}} @@ -900,29 +195,20 @@ \addto\captionsgerman{\def\changesanonymousname{Anonym}} \addto\captionsenglish{\def\changesanonymousname{anonymous}} - \addto\captionsngerman{\def\changesnoloc{\"Anderungsliste erst nach dem n\"achsten \LaTeX-Lauf verf\"ugbar.}} - \addto\captionsgerman{\def\changesnoloc{\"Anderungsliste erst nach dem n\"achsten Durchlauf verf\"ugbar.}} + \addto\captionsngerman{\def\changesnoloc{\"Anderungsliste nach dem n\"achsten \LaTeX-Lauf verf\"ugbar.}} + \addto\captionsgerman{\def\changesnoloc{\"Anderungsliste nach dem n\"achsten Durchlauf verf\"ugbar.}} \addto\captionsenglish{\def\changesnoloc{List of changes is available after the next \LaTeX\ run.}} } % \end{macrocode} % -% \iflanguage{english}{ -% File extension. -% }{ -% Dateiendung. -% } +% File extension. % \begin{macrocode} \newcommand{\Changes@extension}{loc} % \end{macrocode} % % \begin{macro}{\setlocextension} -% \iflanguage{english}{ -% Set new file extension. +% Set a new file extension. % Argument: new extension. -% }{ -% Dieser Befehl überschreibt die Default-Dateiendung. -% Argument: neue Endung -% } % \begin{macrocode} \newcommand{\setlocextension}[1]{ \renewcommand{\Changes@extension}{#1} @@ -930,13 +216,9 @@ % \end{macrocode} % \end{macro} % -% \iflanguage{english}{ -% \subsection{management of authors} -% Authorcount. -% }{ -% \subsection{Autorenverwaltung} -% Autoren-Zähler. -% } +% \subsection{management of authors} +% +% Author counter. % \begin{macrocode} \newcounter{Changes@AuthorCount} \setcounter{Changes@AuthorCount}{0} @@ -944,21 +226,12 @@ % \end{macrocode} % % \begin{macro}{\definechangesauthor} -% \iflanguage{english}{ % Define a new author. -% Arguments: author-id and author's colour. -% Optional argument: author name. +% Mandatory arguments: author's id and author's colour. +% Optional argument: author's name. % -% Store author id, name and colour using named variables. +% Store id, name and colour using named variables. % Define counter and colour per author. -% }{ -% Dieser Befehl definiert einen neuen Autor. -% Argumente: Autor-ID und Farbe des Autors. -% Optionales Argument: Autorenname. -% -% Autor-ID, Name und Farbe mit benannten Variablen merken. -% Pro Autor eigenen Zähler und Farben definieren. -% } % \begin{macrocode} \newcommand{\definechangesauthor}[3][\@empty]{ \stepcounter{Changes@AuthorCount} @@ -973,35 +246,21 @@ % \end{macrocode} % \end{macro} % -% \iflanguage{english}{ -% Define default-author (anonymous). -% }{ -% Default-Autor definieren (anonym). -% } +% Define default-author (anonymous) with empty id and blue color. % \begin{macrocode} \definechangesauthor{\@empty}{blue} % \end{macrocode} % -% \iflanguage{english}{ % Position of the authors markup relative to the text. % \emph{true} = left, \emph{false} = right (default). -% }{ -% Position der Autormarkierung bzgl.\ eingegebenem Text. -% \emph{true} = links, \emph{false} = rechts (default). -% } % \begin{macrocode} \newboolean{Changes@AuthorPositionLeft} \setboolean{Changes@AuthorPositionLeft}{false} % \end{macrocode} % % \begin{macro}{\Changes@AuthorMark} -% \iflanguage{english}{ % Markup of the author. % Default: superscripted. -% }{ -% Ausgabe des Autors bei eingegebenem Text. -% Default: hochgestellt. -% } % \begin{macrocode} \newcommand{\Changes@AuthorMark}[1]{% \textsuperscript{#1}% @@ -1010,11 +269,9 @@ % \end{macro} % % \begin{macro}{\setauthormarkup} -% \iflanguage{english}{ -% Redefining the author markup. -% }{ -% Neudefinition der Autorenausgabe. -% } +% Redefine the author markup. +% Mandatory argument: markup definition. +% Optional argument: markup position (default = left). % \begin{macrocode} \newcommand{\setauthormarkup}[2][left]{% \ifthenelse{\equal{#1}{left}} @@ -1026,13 +283,8 @@ % \end{macro} % % \begin{macro}{\Changes@Remark} -% \iflanguage{english}{ % Markup of remarks. % Default: in a footnote. -% }{ -% Ausgabe der Anmerkung. -% Default: als Fußnote. -% } % \begin{macrocode} \newcommand{\Changes@Remark}[2]{% \footnote{\textcolor{Changes@Color#1}{#2}}% @@ -1041,11 +293,8 @@ % \end{macro} % % \begin{macro}{\setremarkmarkup} -% \iflanguage{english}{ % Redefining the remark markup. -% }{ -% Neudefinition der Anmerkungen. -% } +% Mandatory argument: markup definition. % \begin{macrocode} \newcommand{\setremarkmarkup}[1]{% \renewcommand{\Changes@Remark}[2]{#1}% @@ -1053,29 +302,19 @@ % \end{macrocode} % \end{macro} % -% \iflanguage{english}{ -% \subsection{Change commands} -% Temporary variable for exchange of optional parameters between interlocked commands. -% }{ -% \subsection{Änderungsbefehle} -% Temporärer Speicher, um Parameterübergabe zwischen den geschachtelten Kommandos zu erledigen. -% } +% \subsection{Change commands} +% +% Temporary variable for exchange of optional parameters between interlocked commands. % \begin{macrocode} \newcommand{\Changes@temp}{\@empty} % \end{macrocode} % % \begin{macro}{\added} -% \iflanguage{english}{ % The command formats text as new text. % It's rather complicated for defining a command with two optional parameters. % -% Arguments: author-id (opt.), remark (opt), and new text -% }{ -% Dieser Befehl formatiert den Text als neuen Text. -% Die komplizierte Konstruktion ist nötig, um ein Kommando mit zwei optionalen Argumenten zu definieren. -% -% Argumente: Autor-ID (opt.), Erläuterung (opt.) und neuer Text -% } +% Mandatory argument: added text. +% Optional arguments: author's id, remark % \begin{macrocode} \newcommand{\added}[1][\@empty]{% \renewcommand{\Changes@temp}{#1}% @@ -1104,23 +343,14 @@ % \end{macro} % % \begin{macro}{\deleted} -% \iflanguage{english}{ % The command formats text as deleted text. % It's rather complicated for defining a command with two optional parameters. % -% The \option{final}-part is taken from a tip from \texttt{de.comp.text.tex}. +% The \choption{final}-part is taken from a tip from \texttt{de.comp.text.tex}. % It solves the problem of additional space caused by an empty command. % -% Arguments: author-id (opt.), remark (opt), and deleted text -% }{ -% Dieser Befehl formatiert den Text als gelöschten Text. -% Die komplizierte Konstruktion ist nötig, um ein Kommando mit zwei optionalen Argumenten zu definieren. -% -% Der \option{final}-Teil ist einem Tip von \texttt{de.comp.text.tex} entnommen. -% Er löst das Problem des zusätzlichen Leerraums bei leeren Kommandos. -% -% Argumente: Autor-ID (opt.), Erläuterung (opt.) und gelöschter Text -% } +% Mandatory argument: deleted text. +% Optional arguments: author's id, remark % \begin{macrocode} \newcommand{\deleted}[1][\@empty]{% \renewcommand{\Changes@temp}{#1}% @@ -1149,17 +379,11 @@ % \end{macro} % % \begin{macro}{\replaced} -% \iflanguage{english}{ % The command formats text as replaced text. % It's rather complicated for defining a command with two optional parameters. % -% Arguments: author-id (opt.), remark (opt), new text, and old text -% }{ -% Dieser Befehl formatiert den Text als ersetzten Text. -% Die komplizierte Konstruktion ist nötig, um ein Kommando mit zwei optionalen Argumenten zu definieren. -% -% Argumente: Autor-ID (opt.), Erläuterung (opt.), neuer Text und alter Text -% } +% Mandatory arguments: new text and old text. +% Optional arguments: author's id, remark % \begin{macrocode} \newcommand{\replaced}[1][\@empty]{% \renewcommand{\Changes@temp}{#1}% @@ -1188,18 +412,13 @@ % \end{macrocode} % \end{macro} % -% \iflanguage{english}{ -% \subsection{List of changes} -% }{ -% \subsection{Änderungsliste} -% } +% \subsection{List of changes} % % \begin{macro}{\changes@chopline} -% \iflanguage{english}{ % Auxiliary command for reading the content of the loc-files. -% }{ -% Hilfsbefehl zum Einlesen der loc-Dateien. -% } +% The content is read line by line. +% One line is parsed with this macro, the order of entries is: id, color, name, added, deleted, replaced. +% The contents have to be separated by a semicolon. % \begin{macrocode} \def\changes@chopline#1;#2;#3;#4;#5;#6 \\{ \def\Changes@InID{#1} @@ -1213,13 +432,9 @@ % \end{macro} % % \begin{macro}{\listofchanges} -% \iflanguage{english}{ % This command outputs a list of changes, sorted by authors. % The values are read from the loc-file, if it exists. -% }{ -% Dieser Befehl gibt eine Liste der Änderungen nach Autoren aus. -% Die Werte werden aus der loc-Datei gelesen, wenn diese existiert. -% } +% If no loc-file exists, an according message is generated. % \begin{macrocode} \newcommand{\listofchanges}{% \ifthenelse{\boolean{Changes@optiondraft}} @@ -1261,17 +476,11 @@ % \end{macrocode} % \end{macro} % -% \iflanguage{english}{ -% Writing the list of changes in the loc-file, therefore open file, write values, close file. -% Changes are written as \LaTeX-formatted text, so they can simply be read via \befehl{input}. +% At the end of the document: write the list of changes in the loc-file, therefore open file, write values, close file. +% Changes are written as \LaTeX-formatted text, so they can simply be read via \chcommand{input}. % -% Line format: ID;colour;name;added;deleted;replaced -% }{ -% Ausgabe der Änderungen in loc-Datei, dazu Datei öffnen, Werte herausschreiben, Datei schließen. -% Die Änderungen werden als \LaTeX-formatierter Text ausgegeben, der mit \befehl{input} eingelesen werden kann. -% -% Zeilenformat: ID;Farbe;Name;Zugefügte;Gelöschte;Geänderte -% } +% The order of entries is: id, color, name, added, deleted, replaced. +% The contents have to be separated by a semicolon. % \begin{macrocode} \AtEndDocument{ \newwrite\Changes@OutFile @@ -1295,155 +504,6 @@ % % \end{macrocode} % -%^^A -- Beispieldateien ------------------------------------------------------- -% -% \iflanguage{english}{ -% \section{Example files} -% \subsection{Basic example without \paket{babel}} -% }{ -% \section{Beispieldateien} -% \subsection{Rudimentär ohne \paket{babel}} -% } -% \begin{macrocode} -%<*example:1> -\documentclass{article} - - % draft = Ausgabe der Änderungen -\usepackage[draft]{changes} - -\definechangesauthor{EK}{orange} - -\begin{document} - - Dieses Beispiel zeigt die rudiment\"aren Funktionen. - - \listofchanges - - Dieser Text ist nicht modifiziert. - - Hier \added{f\"uge} ich Text anonym \added{ein}. - Hier \deleted{l\"osche} ich anonym Text. - Und an dieser Stelle \replaced{\"andere}{alt} ich anonym Text. - Anonyme \deleted[][Ja!]{L\"oschung} mit Anmerkung. - - Hier \added[EK]{f\"uge} ich Text als Autor "EK" \added[EK]{ein}. - Hier f\"uge ich \added[EK][Weil ich es kann.]{Text} - als Autor "EK" mit Begr\"undung ein. - -\end{document} -% -% \end{macrocode} -% -% \iflanguage{english}{ -% \subsection{Basic example using \paket{babel}} -% }{ -% \subsection{Rudimentär mit \paket{babel}} -% } -% -% \begin{macrocode} -%<*example:2> -\documentclass[ngerman]{article} - -\usepackage{babel} -\usepackage[utf8]{inputenc} -\RequirePackage[T1]{fontenc} - - % draft = Ausgabe der Änderungen -\usepackage[draft]{changes} - -\definechangesauthor{EK}{orange} - -\begin{document} - - Dieses Beispiel zeigt die rudimentären Funktionen - unter Einbeziehung des babel-Pakets. - - \listofchanges - - Dieser Text ist nicht modifiziert. - - Hier \added{füge} ich Text anonym \added{ein}. - Hier \deleted{lösche} ich anonym Text. - Und an dieser Stelle \replaced{ändere}{alt} ich anonym Text. - Anonyme \deleted[][Ja!]{Löschung} mit Anmerkung. - - Hier \added[EK]{füge} ich Text als Autor "`EK"' \added[EK]{ein}. - Hier füge ich \added[EK][Weil ich es kann.]{Text} - als Autor "`EK"' mit Begründung ein. - -\end{document} -% -% \end{macrocode} -% -% \iflanguage{english}{ -% \subsection{Additional definitions} -% }{ -% \subsection{Erweiterte Einstellungen} -% } -% -% \begin{macrocode} -%<*example:3> -\documentclass[ngerman]{article} - -\usepackage{babel} -\usepackage[utf8]{inputenc} -\RequirePackage[T1]{fontenc} - - % draft = Ausgabe der Änderungen -\usepackage[draft]{changes} - -\definechangesauthor[Ekkart Kleinod]{EK}{orange} -\definechangesauthor{Test}{green} - -\setlocextension{changes} -\setauthormarkup[left]{(#1)~--~} -\setremarkmarkup{(#2:#1)} - -\begin{document} - - Dieses Beispiel zeigt die erweiterten Funktionen. - Es setzt die Erweiterung der Hilfsdatei auf \texttt{changes}. - Ein Autorname wird angegeben. - Die Autorenmarkierung wird links gesetzt. - Sie besteht aus dem eingeklammerten Autorennamen, - der durch Leerzeichen und einen Gedankenstrich - von der Änderung abgesetzt ist. - Die Anmerkung wird in Klammern gesetzt, der Autorname dahinter. - - \listofchanges - - Dieser Text ist nicht modifiziert. - - Hier \added{füge} ich Text anonym \added{ein}. - Hier \deleted{lösche} ich anonym Text. - Und an dieser Stelle \replaced{ändere}{alt} ich anonym Text. - Anonyme \deleted[][Ja!]{Löschung} mit Anmerkung. - - Hier \added[EK]{füge} ich Text als Autor "`EK"' \added[EK]{ein}. - Hier füge ich \added[EK][Weil ich es kann.]{Text} - als Autor "`EK"' mit Begründung ein. - - Hier \deleted[Test][Weil ich es will.]{lösche} ich Text - als Autor "`Text"'. - - Test von Zeilenumbrüchen. - \added{eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt.} - \deleted{gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht.} - \replaced{eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt eingefügt - eingefügt eingefügt eingefügt eingefügt eingefügt.} - {gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht - gelöscht gelöscht gelöscht gelöscht gelöscht gelöscht.} - -\end{document} -% -% \end{macrocode} -% %\Finale \endinput diff --git a/Master/texmf-dist/source/latex/changes/changes.ins b/Master/texmf-dist/source/latex/changes/changes.ins index 08b310ae525..c349a5d425b 100644 --- a/Master/texmf-dist/source/latex/changes/changes.ins +++ b/Master/texmf-dist/source/latex/changes/changes.ins @@ -1,6 +1,6 @@ -%% Diese Datei erzeugt die benötigten Dateien aus changes.dtx +%% This file creates the needed files from changes.dtx %% -\def\filedate{2010/11/21} +\def\filedate{2011/04/25} \def\batchfile{changes.ins} \input docstrip @@ -10,7 +10,7 @@ \preamble changes.dtx -Copyright 2007-2010 Ekkart Kleinod (ekkart@ekkart.de) +Copyright 2007-2011 Ekkart Kleinod (ekkart@ekkart.de) This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 @@ -24,28 +24,36 @@ This work has the LPPL maintenance status `maintained'. The current maintainer of this work is Ekkart Kleinod. This work consists of the files - changes.drv - changes.dtx - changes.ins - README + doc/latex/changes/examples/changes.example.1.de.tex + doc/latex/changes/examples/changes.example.2.de.tex + doc/latex/changes/examples/changes.example.3.de.tex + doc/latex/changes/examples/changes.example.1.de.pdf + doc/latex/changes/examples/changes.example.2.de.pdf + doc/latex/changes/examples/changes.example.3.de.pdf + + source/latex/changes/changes.drv + source/latex/changes/changes.dtx + source/latex/changes/changes.ins + source/latex/changes/README + + scripts/changes/delcmdchanges.bash and the derived files - changes.sty - changes.pdf - changes.example1.tex - changes.example2.tex - changes.example3.tex + doc/latex/changes/changes.english.full.pdf + doc/latex/changes/changes.english.short.pdf + doc/latex/changes/changes.ngerman.full.pdf + doc/latex/changes/changes.ngerman.short.pdf + + tex/latex/changes/changes.sty + \endpreamble \postamble -Copyright 2007-2010 Ekkart Kleinod +Copyright 2007-2011 Ekkart Kleinod \endpostamble \generate{ \file{changes.sty}{\from{changes.dtx}{changes}} - \file{changes.example1.tex}{\from{changes.dtx}{example:1}} - \file{changes.example2.tex}{\from{changes.dtx}{example:2}} - \file{changes.example3.tex}{\from{changes.dtx}{example:3}} } \endinput diff --git a/Master/texmf-dist/tex/latex/changes/changes.sty b/Master/texmf-dist/tex/latex/changes/changes.sty index 6beba57b167..ac814c3f7cb 100644 --- a/Master/texmf-dist/tex/latex/changes/changes.sty +++ b/Master/texmf-dist/tex/latex/changes/changes.sty @@ -7,7 +7,7 @@ %% changes.dtx (with options: `changes') %% %% changes.dtx -%% Copyright 2007-2010 Ekkart Kleinod (ekkart@ekkart.de) +%% Copyright 2007-2011 Ekkart Kleinod (ekkart@ekkart.de) %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either version 1.3 @@ -21,21 +21,32 @@ %% The current maintainer of this work is Ekkart Kleinod. %% %% This work consists of the files -%% changes.drv -%% changes.dtx -%% changes.ins -%% README +%% doc/latex/changes/examples/changes.example.1.de.tex +%% doc/latex/changes/examples/changes.example.2.de.tex +%% doc/latex/changes/examples/changes.example.3.de.tex +%% doc/latex/changes/examples/changes.example.1.de.pdf +%% doc/latex/changes/examples/changes.example.2.de.pdf +%% doc/latex/changes/examples/changes.example.3.de.pdf +%% +%% source/latex/changes/changes.drv +%% source/latex/changes/changes.dtx +%% source/latex/changes/changes.ins +%% source/latex/changes/README +%% +%% scripts/changes/delcmdchanges.bash %% and the derived files -%% changes.sty -%% changes.pdf -%% changes.example1.tex -%% changes.example2.tex -%% changes.example3.tex +%% doc/latex/changes/changes.english.full.pdf +%% doc/latex/changes/changes.english.short.pdf +%% doc/latex/changes/changes.ngerman.full.pdf +%% doc/latex/changes/changes.ngerman.short.pdf +%% +%% tex/latex/changes/changes.sty +%% %% \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{changes} -[2010/11/22 v0.5.3 changes-Paket] -\typeout{*** changes-Paket 2010/11/22 v0.5.3 ***} +[2011/04/25 v0.5.4 changes-Paket] +\typeout{*** changes-Paket 2011/04/25 v0.5.4 ***} \RequirePackage{xkeyval} \RequirePackage{ifthen} \newboolean{Changes@optiondraft} @@ -65,13 +76,13 @@ \RequirePackage{ulem} \ifthenelse{\isundefined{\addto}} { -\def\listchangesname{\"Anderungen} -\def\changesaddname{Eingef\"ugt} -\def\changesdeletename{Gel\"oscht} -\def\changesreplacename{Ersetzt} -\def\changesauthorname{Autor} -\def\changesanonymousname{Anonym} -\def\changesnoloc{\"Anderungsliste erst nach dem n\"achsten Durchlauf verf\"ugbar.} +\def\listchangesname{Changes} +\def\changesaddname{Added} +\def\changesdeletename{Deleted} +\def\changesreplacename{Replaced} +\def\changesauthorname{Author} +\def\changesanonymousname{anonymous} +\def\changesnoloc{List of changes is available after the next \LaTeX\ run.} }{ \addto\captionsngerman{\def\listchangesname{\"Anderungen}} \addto\captionsgerman{\def\listchangesname{\"Anderungen}} @@ -97,8 +108,8 @@ \addto\captionsgerman{\def\changesanonymousname{Anonym}} \addto\captionsenglish{\def\changesanonymousname{anonymous}} -\addto\captionsngerman{\def\changesnoloc{\"Anderungsliste erst nach dem n\"achsten \LaTeX-Lauf verf\"ugbar.}} -\addto\captionsgerman{\def\changesnoloc{\"Anderungsliste erst nach dem n\"achsten Durchlauf verf\"ugbar.}} +\addto\captionsngerman{\def\changesnoloc{\"Anderungsliste nach dem n\"achsten \LaTeX-Lauf verf\"ugbar.}} +\addto\captionsgerman{\def\changesnoloc{\"Anderungsliste nach dem n\"achsten Durchlauf verf\"ugbar.}} \addto\captionsenglish{\def\changesnoloc{List of changes is available after the next \LaTeX\ run.}} } \newcommand{\Changes@extension}{loc} @@ -268,6 +279,6 @@ } \closeout\Changes@OutFile } -%% Copyright 2007-2010 Ekkart Kleinod +%% Copyright 2007-2011 Ekkart Kleinod %% %% End of file `changes.sty'. -- cgit v1.2.3