diff options
author | Hironobu Yamashita <h.y.acetaminophen@gmail.com> | 2019-03-15 11:46:02 +0000 |
---|---|---|
committer | Hironobu Yamashita <h.y.acetaminophen@gmail.com> | 2019-03-15 11:46:02 +0000 |
commit | c06f70d44ffa50fd25b9239db5cae10be9758f10 (patch) | |
tree | 8064c8bc807b6f5fb6632ed496aabe0028c7d918 /Build/source/texk/bibtex-x | |
parent | 90848d05c3d37a4513322d582ff3214b49ad367c (diff) |
man pages for bibtex8, bibtexu
git-svn-id: svn://tug.org/texlive/trunk@50398 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/bibtex-x')
-rw-r--r-- | Build/source/texk/bibtex-x/ChangeLog | 5 | ||||
-rw-r--r-- | Build/source/texk/bibtex-x/Makefile.am | 4 | ||||
-rw-r--r-- | Build/source/texk/bibtex-x/Makefile.in | 71 | ||||
-rw-r--r-- | Build/source/texk/bibtex-x/bibtex8.1 | 100 | ||||
-rw-r--r-- | Build/source/texk/bibtex-x/bibtexu.1 | 64 |
5 files changed, 232 insertions, 12 deletions
diff --git a/Build/source/texk/bibtex-x/ChangeLog b/Build/source/texk/bibtex-x/ChangeLog index 7efbf111826..35055f15017 100644 --- a/Build/source/texk/bibtex-x/ChangeLog +++ b/Build/source/texk/bibtex-x/ChangeLog @@ -1,3 +1,8 @@ +2019-03-15 Hironobu Yamashita <h.y.acetaminophen@gmail.com> + + * Makefile.am: Add bibtex8.1 and bibtexu.1. + * bibtex8.1, bibtexu.1: New man pages. + 2019-03-06 Hironobu Yamashita <h.y.acetaminophen@gmail.com> * bibtex-2.c: Check error status for every call of diff --git a/Build/source/texk/bibtex-x/Makefile.am b/Build/source/texk/bibtex-x/Makefile.am index 655b5e4cc10..13cc3bebb8a 100644 --- a/Build/source/texk/bibtex-x/Makefile.am +++ b/Build/source/texk/bibtex-x/Makefile.am @@ -1,7 +1,7 @@ ## $Id$ ## Makefile.am for the TeX Live subdirectory texk/bibtex-x/ ## -## Copyright 2017 Peter Breitenlohner <tex-live@tug.org> +## Copyright 2017-2019 Karl Berry <tex-live@tug.org> ## Copyright 2009-2015 Peter Breitenlohner <tex-live@tug.org> ## You may freely use, modify and/or distribute this file. ## @@ -46,6 +46,8 @@ bibtexu_CPPFLAGS = $(AM_CPPFLAGS) $(ICU_INCLUDES) -DUTF_8 $(bibtexu_OBJECTS): $(KPATHSEA_DEPEND) $(ICU_DEPEND) bibtexu_LDADD = $(KPATHSEA_LIBS) $(ICU_LIBS) $(ICU_LIBS_EXTRA) +dist_man1_MANS = bibtex8.1 bibtexu.1 + ## Rebuild libkpathsea @KPATHSEA_RULE@ ## Rebuild libsicuxxx diff --git a/Build/source/texk/bibtex-x/Makefile.in b/Build/source/texk/bibtex-x/Makefile.in index 6f6be05885b..b2a624fe211 100644 --- a/Build/source/texk/bibtex-x/Makefile.in +++ b/Build/source/texk/bibtex-x/Makefile.in @@ -121,8 +121,8 @@ CONFIG_CLEAN_FILES = CONFIG_CLEAN_VPATH_FILES = @BIBTEX8_TRUE@am__EXEEXT_1 = bibtex8$(EXEEXT) @BIBTEXU_TRUE@am__EXEEXT_2 = bibtexu$(EXEEXT) -am__installdirs = "$(DESTDIR)$(bindir)" "$(DESTDIR)$(btdocdir)" \ - "$(DESTDIR)$(csfdir)" +am__installdirs = "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)" \ + "$(DESTDIR)$(btdocdir)" "$(DESTDIR)$(csfdir)" PROGRAMS = $(bin_PROGRAMS) am__objects_1 = bibtex8-bibtex-1.$(OBJEXT) bibtex8-bibtex-2.$(OBJEXT) \ bibtex8-bibtex-3.$(OBJEXT) bibtex8-bibtex-4.$(OBJEXT) \ @@ -236,6 +236,9 @@ am__uninstall_files_from_dir = { \ || { echo " ( cd '$$dir' && rm -f" $$files ")"; \ $(am__cd) "$$dir" && rm -f $$files; }; \ } +man1dir = $(mandir)/man1 +NROFF = nroff +MANS = $(dist_man1_MANS) DATA = $(dist_btdoc_DATA) $(dist_csf_DATA) am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) \ $(LISP)config.h.in @@ -433,8 +436,8 @@ am__set_b = \ *) \ b='$*';; \ esac -am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/config.h.in \ - $(top_srcdir)/../../build-aux/compile \ +am__DIST_COMMON = $(dist_man1_MANS) $(srcdir)/Makefile.in \ + $(srcdir)/config.h.in $(top_srcdir)/../../build-aux/compile \ $(top_srcdir)/../../build-aux/config.guess \ $(top_srcdir)/../../build-aux/config.sub \ $(top_srcdir)/../../build-aux/depcomp \ @@ -623,6 +626,7 @@ bibtexu_SOURCES = $(common_sources) nodist_EXTRA_bibtexu_SOURCES = dummy.cxx bibtexu_CPPFLAGS = $(AM_CPPFLAGS) $(ICU_INCLUDES) -DUTF_8 bibtexu_LDADD = $(KPATHSEA_LIBS) $(ICU_LIBS) $(ICU_LIBS_EXTRA) +dist_man1_MANS = bibtex8.1 bibtexu.1 csfdir = $(datarootdir)/texmf-dist/bibtex/csf/base dist_csf_DATA = \ csf/88591lat.csf \ @@ -1028,6 +1032,47 @@ clean-libtool: distclean-libtool: -rm -f libtool config.lt +install-man1: $(dist_man1_MANS) + @$(NORMAL_INSTALL) + @list1='$(dist_man1_MANS)'; \ + list2=''; \ + test -n "$(man1dir)" \ + && test -n "`echo $$list1$$list2`" \ + || exit 0; \ + echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \ + { for i in $$list1; do echo "$$i"; done; \ + if test -n "$$list2"; then \ + for i in $$list2; do echo "$$i"; done \ + | sed -n '/\.1[a-z]*$$/p'; \ + fi; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \ + done; } + +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list='$(dist_man1_MANS)'; test -n "$(man1dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir) install-dist_btdocDATA: $(dist_btdoc_DATA) @$(NORMAL_INSTALL) @list='$(dist_btdoc_DATA)'; test -n "$(btdocdir)" || list=; \ @@ -1455,9 +1500,9 @@ distcleancheck: distclean check-am: all-am $(MAKE) $(AM_MAKEFLAGS) check-TESTS check: check-am -all-am: Makefile $(PROGRAMS) $(DATA) config.h +all-am: Makefile $(PROGRAMS) $(MANS) $(DATA) config.h installdirs: - for dir in "$(DESTDIR)$(bindir)" "$(DESTDIR)$(btdocdir)" "$(DESTDIR)$(csfdir)"; do \ + for dir in "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(btdocdir)" "$(DESTDIR)$(csfdir)"; do \ test -z "$$dir" || $(MKDIR_P) "$$dir"; \ done install: install-am @@ -1529,7 +1574,8 @@ info: info-am info-am: -install-data-am: install-dist_btdocDATA install-dist_csfDATA +install-data-am: install-dist_btdocDATA install-dist_csfDATA \ + install-man install-dvi: install-dvi-am @@ -1545,7 +1591,7 @@ install-info: install-info-am install-info-am: -install-man: +install-man: install-man1 install-pdf: install-pdf-am @@ -1590,7 +1636,9 @@ ps: ps-am ps-am: uninstall-am: uninstall-binPROGRAMS uninstall-dist_btdocDATA \ - uninstall-dist_csfDATA + uninstall-dist_csfDATA uninstall-man + +uninstall-man: uninstall-man1 .MAKE: all check-am install-am install-strip @@ -1606,13 +1654,14 @@ uninstall-am: uninstall-binPROGRAMS uninstall-dist_btdocDATA \ install-data-am install-dist_btdocDATA install-dist_csfDATA \ install-dvi install-dvi-am install-exec install-exec-am \ install-html install-html-am install-info install-info-am \ - install-man install-pdf install-pdf-am install-ps \ + install-man install-man1 install-pdf install-pdf-am install-ps \ install-ps-am install-strip installcheck installcheck-am \ installdirs maintainer-clean maintainer-clean-generic \ mostlyclean mostlyclean-compile mostlyclean-generic \ mostlyclean-libtool pdf pdf-am ps ps-am recheck tags tags-am \ uninstall uninstall-am uninstall-binPROGRAMS \ - uninstall-dist_btdocDATA uninstall-dist_csfDATA + uninstall-dist_btdocDATA uninstall-dist_csfDATA uninstall-man \ + uninstall-man1 .PRECIOUS: Makefile diff --git a/Build/source/texk/bibtex-x/bibtex8.1 b/Build/source/texk/bibtex-x/bibtex8.1 new file mode 100644 index 00000000000..4a5b66f3cbe --- /dev/null +++ b/Build/source/texk/bibtex-x/bibtex8.1 @@ -0,0 +1,100 @@ +.TH BIBTEX8 "1" "March 2019" "bibtex8 3.71" "User Commands" +.SH NAME +bibtex8 \- 8-bit Big BibTeX +.SH SYNOPSIS +.B bibtex8 +[\fIoptions\fR] \fIaux-file\fR +.SH DESCRIPTION +.PP +.B BibTeX8 +is an 8-bit implementation of BibTeX written in C. +It has been enhanced by adding the following features: +.PP +- "big" (32-bit) and customisable capacity +.PP +- flexible support for non-English languages using 8-bit character sets +.PP +.B BibTeX8 +accepts 8-bit characters in its input files, and writes 8-bit +characters to its output files. The character set is defined by an +external configuration file --- the Codepage and Sort order ("CS") file. +By default, it reads a specific CS file "88591lat.csf", which defines +ISO 8859-1 character set and its alphabetical sorting order including +accented characters. +.SH OPTIONS +.TP +\fB\-?\fR \fB\-\-help\fR +display some brief help text. +.TP +\fB\-7\fR \fB\-\-traditional\fR +operate in the original 7\-bit mode, no CS file used. +Only 7\-bit ASCII characters are supported, and they are +sorted by ASCII code value. +.TP +\fB\-8\fR \fB\-\-8bit\fR +force 8\-bit mode, no CS file used. +All 8\-bit characters (code > 127) are treated as letters, +and they are sorted by their code value. +.TP +\fB\-c\fR \fB\-\-csfile\fR FILE +read FILE as the BibTeX character set +and sort definition file. +Note that options \fB\-7\fR, \fB\-8\fR and \fB\-c\fR are exclusive. +.TP +\fB\-d\fR \fB\-\-debug\fR TYPE +report debugging information. TYPE is one +or more of all, csf, io, mem, misc, search. +.TP +\fB\-s\fR \fB\-\-statistics\fR +report internal statistics. +.TP +\fB\-t\fR \fB\-\-trace\fR +report execution tracing. +.TP +\fB\-v\fR \fB\-\-version\fR +report BibTeX version. +.TP +\fB\-B\fR \fB\-\-big\fR +set large BibTeX capacity. +.TP +\fB\-H\fR \fB\-\-huge\fR +set huge BibTeX capacity. +.TP +\fB\-W\fR \fB\-\-wolfgang\fR +set really huge BibTeX capacity for Wolfgang. +.TP +\fB\-M\fR \fB\-\-min_crossrefs\fR ## +set min_crossrefs to ##. +.TP +\fB\-\-mcites\fR ## +allow ## \ecites in the .aux files (deprecated). +.TP +\fB\-\-mentints\fR ## +allow ## integer entries in the .bib databases (deprecated). +.TP +\fB\-\-mentstrs\fR ## +allow ## string entries in the .bib databases (deprecated). +.TP +\fB\-\-mfields\fR ## +allow ## fields in the .bib databases (deprecated). +.TP +\fB\-\-mpool\fR ## +set the string pool to ## bytes (deprecated). +.TP +\fB\-\-mstrings\fR ## +allow ## unique strings. +.TP +\fB\-\-mwizfuns\fR ## +allow ## wizard functions (deprecated). +.SH SEE ALSO +More detailed description of +.B BibTeX8 +is available at $TEXMFDIST/doc/bibtex8/00readme.txt. +The syntax of Codepage and Sort order (CS) File can be found at +$TEXMFDIST/doc/bibtex8/csfile.txt. +.SH AUTHORS +.B BibTeX8 +was written by Niel Kempson <kempson@snowyowl.co.uk> and +Alejandro Aguilar-Sierra <asierra@servidor.unam.mx>. +This manpage was written for TeX Live, based on the work +by Norbert Preining for Debian/GNU Linux. diff --git a/Build/source/texk/bibtex-x/bibtexu.1 b/Build/source/texk/bibtex-x/bibtexu.1 new file mode 100644 index 00000000000..6c1f6aaed65 --- /dev/null +++ b/Build/source/texk/bibtex-x/bibtexu.1 @@ -0,0 +1,64 @@ +.TH BIBTEXU "1" "March 2019" "bibtexu 3.71" "User Commands" +.SH NAME +bibtexu \- UTF-8 Big BibTeX +.SH SYNOPSIS +.B bibtexu +[\fIoptions\fR] \fIaux-file\fR +.SH DESCRIPTION +.PP +.B BibTeXu +is the Unicode-compliant version of BibTeX. +It is largely based on Niel Kempson's BibTeX8, and it provides +a better support for UTF-8 by integrating ICU library. Therefore, +.B BibTeXu +no longer requires the Codepage and Sort order ("CS") file; instead, +the method of sorting and case-changing can be controled via +command-line options. +.SH OPTIONS +.TP +\fB\-?\fR \fB\-\-help\fR +display some brief help text. +.TP +\fB\-d\fR \fB\-\-debug\fR TYPE +report debugging information. TYPE is one +or more of all, csf, io, mem, misc, search. +.TP +\fB\-s\fR \fB\-\-statistics\fR +report internal statistics. +.TP +\fB\-t\fR \fB\-\-trace\fR +report execution tracing. +.TP +\fB\-v\fR \fB\-\-version\fR +report BibTeX version. +.TP +\fB\-l\fR \fB\-\-language\fR LANG +use language LANG to convert strings to low case. +This argument is passed to ICU library. +.TP +\fB\-o\fR \fB\-\-location\fR LANG +use language LANG for sorting. +This argument is passed to ICU library. +.TP +\fB\-B\fR \fB\-\-big\fR +set large BibTeX capacity. +.TP +\fB\-H\fR \fB\-\-huge\fR +set huge BibTeX capacity. +.TP +\fB\-W\fR \fB\-\-wolfgang\fR +set really huge BibTeX capacity for Wolfgang. +.TP +\fB\-M\fR \fB\-\-min_crossrefs\fR ## +set min_crossrefs to ##. +.TP +\fB\-\-mstrings\fR ## +allow ## unique strings. +.SH SEE ALSO +More detailed description of +.B BibTeXu +is available at $TEXMFDIST/doc/bibtexu/README. +.SH AUTHORS +.B BibTeXu +was written by Yannis Haralambous and his students. +This manpage was written for TeX Live. |