diff options
author | Karl Berry <karl@freefriends.org> | 2021-06-26 20:36:50 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-06-26 20:36:50 +0000 |
commit | 68fdb8a3001008c2e51dd154f92e0964935e77b3 (patch) | |
tree | 035848061b87e85a41c28716862ccca6ad8b0ce0 /Master/texmf-dist/doc/support | |
parent | ad598f4c314e9692378b6534d4f73e72e23c6cf5 (diff) |
ctanbib (26jun21)
git-svn-id: svn://tug.org/texlive/trunk@59718 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r-- | Master/texmf-dist/doc/support/ctanbib/README.md | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.pdf | bin | 35575 -> 35307 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.tex | 62 |
3 files changed, 43 insertions, 21 deletions
diff --git a/Master/texmf-dist/doc/support/ctanbib/README.md b/Master/texmf-dist/doc/support/ctanbib/README.md index 263cd82a1a1..a6147f125d7 100644 --- a/Master/texmf-dist/doc/support/ctanbib/README.md +++ b/Master/texmf-dist/doc/support/ctanbib/README.md @@ -10,7 +10,7 @@ This script can generate BibTeX records for LaTeX packages hosted on CTAN. More details can be found on [TeX.sx](https://tex.stackexchange.com/a/200856/2891) -Copyright: 2019 Michal Hoftich +Copyright: 2021 Michal Hoftich This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 diff --git a/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.pdf b/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.pdf Binary files differindex ec58084d270..1fb514277c7 100644 --- a/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.pdf +++ b/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.pdf diff --git a/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.tex b/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.tex index 89b99279b51..c9d2a96abeb 100644 --- a/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.tex +++ b/Master/texmf-dist/doc/support/ctanbib/ctanbib-doc.tex @@ -25,7 +25,11 @@ This package provides script named \package{ctanbib} which can be used for retri It can be used in the following way: -\noindent\package{ctanbib [options] $\langle$packagename$\rangle$ > filename.bib} +\medskip + +\noindent\package{ctanbib [options] $\langle$packagename1$\rangle$ \ldots\ $\langle$packagenameX$\rangle$ > filename.bib} + +\medskip The \texttt{curl} utility needs to be installed on the user's system in order to support the package info download. @@ -33,10 +37,8 @@ The \texttt{curl} utility needs to be installed on the user's system in order to \section{Available options} \begin{description} - \item[-c,-\/-ctan] use the \texttt{@ctan} type instead of \texttt{@manual}. - The difference between the two is that the url field contains packages CTAN - path, instead of a link to the package. - \item[-C,-\/-CTAN] like \verb|--ctan| option, but use original url instead of CTAN path. + \item[-c,-\/-ctan] use the CTAN package entry as package URL instead of URL provided by the package. + \item[-e,-\/-entrypoint] explicitly set the Bib\TeX\ entry type. \item[-h,-\/-help] print the help message. \item[-v,-\/-version] print the version info. \end{description} @@ -55,31 +57,44 @@ ctanbib latex @manual{latex, title = {The Latex package}, subtitle = {A TeX macro package that defines LaTeX}, -author = {Lamport, Leslie and The LaTeX Team}, +author = {{The LaTeX Team} and Lamport, Leslie}, url = {http://www.latex-project.org/}, -urldate = {2018-08-23}, -date = {2018-04-01}, -version = {PL 5} +urldate = {2021-06-26}, +date = {}, +version = {2021-06-01}, } \end{verbatim} -The \texttt{--ctan} option: +\noindent The \texttt{--ctan} option: \begin{verbatim} -ctanbib -c hyperref +ctanbib -c latex \end{verbatim} -\noindent This produces a bib record with the \texttt{@ctan} type: +\noindent This produces a bib record that uses the CTAN package entry for the URL, +instead of the original package URL. + \begin{verbatim} -@ctan{hyperref, -title = {The Hyperref package}, -subtitle = {Extensive support for hypertext in LaTeX}, -author = {Rahtz, Sebastian and Oberdiek, Heiko}, -url = {/macros/latex/contrib/hyperref}, -urldate = {2018-08-27}, -date = {}, -version = {6.86b} +@manual{latex, +title = {The Latex package}, +... +url = {https://ctan.org/pkg/latex}, +... +} +\end{verbatim} + +\noindent The \texttt{--entrytype} option: + +\begin{verbatim} +ctanbib -e ctan latex +\end{verbatim} + +\noindent It selects different entry type for the record: + +\begin{verbatim} +@ctan{latex, +... } \end{verbatim} @@ -100,6 +115,13 @@ it's eventual release on CTAN. Herbert Voss added the \verb|--CTAN| option. \section{Changelog} \begin{changelog} + \change{2021-06-26}{Version 0.2 released} + \change{2021-06-26}{Removed the \verb|--CTAN| option, entry type can be set using \verb|--entrytype| and CTAN URL is requested using \verb|--ctan|} + \change{2021-06-26}{Added \verb|--entrytype| option for explicit specification of the Bib\TeX\ entry type} + \change{2021-06-26}{Fixed package name verification} + \change{2021-06-26}{Added support for multiple package names} + \change{2021-06-26}{Print \verb|https://www.ctan.org/pkg/<pkgname>| with the \texttt{-c} option} + \change{2021-06-20}{Version 0.1e released} \change{2021-06-20}{Added \verb|--CTAN| option, thanks to Herbert Voss} \change{2019-12-23}{Don't return non-zero exit codes for non-error runs} \change{2019-12-23}{Test for the packagename with the \texttt{-c} option} |