summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/bibarts/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/bibarts/README.txt')
-rw-r--r--macros/latex/contrib/bibarts/README.txt112
1 files changed, 85 insertions, 27 deletions
diff --git a/macros/latex/contrib/bibarts/README.txt b/macros/latex/contrib/bibarts/README.txt
index 8fbb2c100f..701eb35450 100644
--- a/macros/latex/contrib/bibarts/README.txt
+++ b/macros/latex/contrib/bibarts/README.txt
@@ -7,7 +7,7 @@ it requires a program, for which source and Windows executable are provided.
===
-BibArts 2.4 is a LaTeX package to assist in making bibliographical features
+BibArts 2.5 is a LaTeX package to assist in making bibliographical features
common in the arts and humanities (history, political science, etc.).
bibarts.sty provides commands for quotation, register keywords,
abbreviations, and especially for a formatted citation of literature,
@@ -22,18 +22,18 @@ with BibTeX, and it does not use any data bank except your own LaTeX text.
The lists are created by bibsort. A file bibsort.exe is part of the package
( CTAN mirrors > BibArts > bibarts.zip ) and runs on newer Windows systems.
Other users first have to create a binary file from bibsort.c (ANSI-C) with
-their own C-compiler. BibArts 2.4 is developed and tested on Windows 10
-with the 2021-11-22 LaTeX 2e distribution, but it should be able to work
+their own C-compiler. BibArts 2.5 is developed and tested on Windows 10
+with the 2022-06-01 LaTeX 2e distribution, but it should be able to work
even with LaTeX 2.09.
- BibArts 2.4 (9 files, 8 dated 2022-01-10):
- README.txt This file here
+ BibArts 2.5 (9 files, 8 dated 2022-10-01):
+ README.txt This file here: Version history
bibarts.sty The LaTeX style file
ba-short.pdf Short introduction (English)
ba-short.tex Source of ba-short.pdf
bibarts.pdf Full documentation (German)
bibarts.tex Source of bibarts.pdf
- bibsort.exe Binary to create the lists
+ bibsort.exe bibarts-bin to create the lists
bibsort.c Source of bibsort.exe
COPYING License (dated 1993-11-28)
@@ -64,7 +64,7 @@ see examples for the new commands \frompagesep and \ntsep in bibarts.pdf.
Changes from BibArts version 2.0 (2015) to version 2.1 (2016):
-BibArts 2.0 set \footnotesep to 2ex, whereas 2.1 to 2.4 do *not* change the
+BibArts 2.0 set \footnotesep to 2ex, whereas 2.1 to 2.5 do *not* change the
pre-set value. If you want to continue with the 2.0-distance between two
footnotes, you will have to type \setlength{\footnotesep}{2ex} in your text.
@@ -87,7 +87,7 @@ bibsort is able to evaluate the new fnsymbols (which expand to \TextOrMath).
If bibsort should write into files with a different prefix as the .aux input
file, you have to use -o <outfile> now. And you may type bibsort <infile>,
-*or* bibsort -i <infile> (e.g. when the input file name begins with '-').
+*or* bibsort -i <infile> (e.g. if the input file name begins with '-').
bibsort sorts the 'official' $Greek variables$ since version 2.0. To write
single words in Old Greek, BibArts 2.1 also provides \Alpha [A], \Beta [B],
@@ -99,12 +99,15 @@ single words in Old Greek, BibArts 2.1 also provides \Alpha [A], \Beta [B],
Changes from BibArts version 2.1 (2016) to version 2.2 (2019):
-(1) bibsort, the sorting program of the package, has 3 new options:
+(1) bibsort, the BibArts Program to create the lists, has 3 new options:
Use bibsort -h [...] to sort hyphens ( - \hy \fhy "= "~ ) as spaces.
-Use bibsort -b [...] to begin the sorting of the title at \bago, e.g.:
+Use bibsort -b [...] if you want that your command \bago in an argument
+should define the position at which each comparison begins. E.g. ...
\vli{J.}{Smith}{The \bago \ktit{Book}, London 2005}
+... with -b will be sorted like <Smith J Book London 2005> without 'The'.
+(If you did not type \bago, the position is at the begin of the argument.)
bibsort -n1 [...] will create blocks of footnote numbers only, if
the entries are from footnotes on the same page, e.g.: 10^{3-6}, 11^{7-9}
@@ -127,8 +130,8 @@ And errors in the sorting of entries with only-commands were eliminated.
full stop between name and title; BibArts is avoiding e.g. "Smith, J..".
(6) If you '\renewcommand' a pre-defined text element (caption), you
-sometimes will have to adapt the italic correction. Bibarts provides
-the homogenous command \bacorr instead of the four different commands
+sometimes will have to adapt the italic correction. BibArts provides
+the homogeneous command \bacorr instead of the four different commands
\bakxxcorr, \baabkcorr, \balistcorr, and \bakntsepcorr (but those old
commands are still valid). To print the lists, you may say now e.g.:
\renewcommand{\frompagesep}{\bacorr ; } \printnumvli \printnumvkc
@@ -144,8 +147,8 @@ german.sty or ngerman.sty, the use of \originalTeX is still reproduced.
- \newhyss to set a \ss, which is splitted s-s only in small caps, and
else is printing a sharp S, which is splitted as \language says (-\ss);
- \hyss to execute \oldhyss, if \language is \l@german, and \newhyss else
- (e.g. if \language is \l@ngerman --- so, \hyss can be used *always*);
-- commands for the handling of "tripple consonant before vovel" in German:
+ (e.g. if \language is \l@ngerman), so you can use \hyss in all languages;
+- commands to handle the "tripple consonant in front of vovel" in German:
E.g. Sto\hyf figur, Scha\hyl leistung, Sta\hym mutter, Ke\hyn nummer,
Ste\hyp pullover, Sta\hyr rahmen, and Schri\hyt tempo: If \language is
\l@german, BibArts will PRINT AND SORT \hyf as f, and ELSE as ff, etc.
@@ -165,12 +168,12 @@ Changes from BibArts version 2.2 (2019) to version 2.3 (2021):
There have been two new options for bibsort:
- -utf8 sorts UTF8 characters as definded in utf8enc.dfu 2021/01/27 v1.2l,
+ -utf8 sorts UTF-8 characters as definded in utf8enc.dfu 2021/01/27 v1.2l,
except \cyr...- and \CYR...-commands, which bibsort still ignores.
- bibsort is able to sort the accent \textcommabelow (parallel to
- U+0218 to U+021B). The internal representation of accents did
- change (two instead of one ASCII 1 to 31). For numerous smaller
- changes see /* 2.3 comments */ in bibsort.c.
+ bibsort is able to sort the accent \textcommabelow (which LaTeX
+ uses from U+0218 to U+021B). The internal representation of
+ accents did change (two instead of one ASCII 1 to 31). For
+ numerous smaller changes see /* 2.3 comments */ in bibsort.c.
Like in earlier versions, you can introduce e.g. a book in your text
@@ -178,33 +181,88 @@ There have been two new options for bibsort:
with Peter Young as co-author. (For further co-authors, use
\midvauthor{FirstName}{LastName}
in front of \vauthor.) Please always TYPE the FirstName first.
- If you start bibsort without -e, \printvli will still print lists as:
- Smith, John / Peter Young: ... [Title] ...
- -e exchanges the PRINT ORDER of the args of \vauthor (and \midvauthor).
- In your text, \printvli then will PRINT the List of Literature as:
+ -e exchanges the PRINT ORDER of the args of \vauthor (and \midvauthor)
+ on the List of Literature. So, \printvli will PRINT:
Smith, John / Young, Peter: ... [Title] ...
+ If you start bibsort without -e, \printvli will still print:
+ Smith, John / Peter Young: ... [Title] ...
+
The SORT ORDER in *both* cases is (that did/does *not* change):
Smith John Young Peter
===
-Changes from BibArts version 2.3 (2021) to version 2.4 (now, 2022):
+Changes from BibArts version 2.3 (2021) to version 2.4 (2022) [2022a]:
An error was fixed concerning "inner v-commands" on the List of Literature,
and the List of Published Documents: In shortened "inner" references,
BibArts 2.3 -- together with bibsort -e ... -- printed the first names of
co-authors. Now, such shortened references only print the family names.
-bibsort now knows ten new utf8-characters (parallel to the changes in
+bibsort now knows ten new UTF-8 characters (according to the changes in
utf8enc.dfu from version 2021/01/27 v1.2l to 2021/06/21 v1.2n).
===
+Changes from BibArts version 2.4 (2022[a]) to version 2.5 (now, 2022b):
+
+
+(1) You may now put curly brackets around the \ktit{shortened title}, e.g.:
+
+ \vli {K.} {Mayer} {The \textbf {\ktit{Book}}, Frankfurt/M.}.
+
+Older versions, despite \announcektit, did not print "(cited as ...)" in
+that case. Now, this error has been fixed, and \vli prints correctly:
+
+ K. Mayer: The Book, Frankfurt/M. (cited as Mayer: Book [L]).
+
+
+(2) bibarts.sty now searches for a full stop at the end of the last argument
+of \vli commands. So, you may set \notannouncektit, and you will get:
+
+ K. Mayer: The Book, Frankfurt/M.
+
+(BibArts 2.5 automatically prints "." instead of ".." at the end.)
+
+
+(3) BibArts now supports the name-year system. In this feature, the last
+argument of a shortened reference \kli consists of the year of publication
+(instead of a few words from the full title). In this new system, you also
+use \ktit in the full reference \vli, but in the optional *{argument} as:
+
+ \footnote{\vli {J.} {Smith} *{\onlyvoll{\ktit{2022}}} {An Alternative}.}
+ ...
+ \footnote{\kli {Smith} {2022}.} %% <= automatically prints IBIDEM.
+
+The \ktit in the *{argument} of the full reference \vli has to be masked by
+\onlyvoll; only then, BibArts will print IBIDEM, if \kli{Smith}{2022} is in
+the following footnote. Instead of especially *{\onlyvoll{\ktit{2022}}},
+you may use *{\starktit{2022}} as a shorter synonym; also see ba-short.pdf.
+
+After a start of the BibArts program bibsort, and a second start of LaTeX,
+\printvli prints the List of Literature from the given name-year example as:
+
+ Smith, J. 2022: An Alternative.
+
+
+(4) Anyway, \ktit now is no more necessarily in the last argument of a \vli
+command. The new bibsort tells you whether you have always chosen the same
+argument (where "arg 3" means the optional *{argument}, and "arg 4" the last
+argument). To get the new features, bibsort, and bibarts.sty, both need to
+be updated to version 2.5. bibsort is sometimes referred to as bibarts-bin.
+
+
+(5) bibsort now knows further eleven UTF-8 characters (according to the
+changes in utf8enc.dfu from version 2021/06/21 v1.2n to 2022/06/07 v1.3c).
+
+
+===
+
Published under the terms of the GNU General Public License.
-BibArts 2.4 (2022):
-(C) Timo Baumann, Versions 2.x (2022, 2021, 2019, 2016, 2015)
+BibArts 2.5 (2022b):
+(C) Timo Baumann, Versions 2.x (2015-2022)