bib-example.texi(,2) @c % Copyright (C) 2004 Aaron S. Hawley bib-example.texi(,3) bib-example.texi(,4) @c % Author: Aaron S. Hawley bib-example.texi(,5) @c % Keywords: docs, texinfo, extensions, bib bib-example.texi(,6) bib-example.texi(,7) @c % This file is free software; you can redistribute it and/or modify bib-example.texi(,8) @c % it under the terms of the GNU General Public License as published by bib-example.texi(,9) @c % the Free Software Foundation; either version 2, or (at your option) bib-example.texi(,10) @c % any later version. bib-example.texi(,11) bib-example.texi(,12) @c % This file is distributed in the hope that it will be useful, bib-example.texi(,13) @c % but WITHOUT ANY WARRANTY; without even the implied warranty of bib-example.texi(,14) @c % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the bib-example.texi(,15) @c % GNU General Public License for more details. bib-example.texi(,16) bib-example.texi(,17) @c % You should have received a copy of the GNU General Public License bib-example.texi(,18) @c % along with texi2html; see the file COPYING. If not, write to bib-example.texi(,19) @c % the Free Software Foundation, Inc., 59 Temple Place - Suite 330, bib-example.texi(,20) @c % Boston, MA 02111-1307, USA. bib-example.texi(,21) bib-example.texi(,22) @comment %**start of header bib-example.texi(,23) @setfilename my-file-with-bib.info bib-example.texi(,24) @settitle Texinfo with a Bibliography and References bib-example.texi(,25) ./my-bib-macros.texi(,1) ./my-bib-macros.texi(,1) @c \input texinfo @c -*-texinfo-*- ./my-bib-macros.texi(,2) @c %% my-bib-macros.texi --- Texinfo macros providing a crude ./my-bib-macros.texi(,3) @c %% bibliography and citation capability. ./my-bib-macros.texi(,4) ./my-bib-macros.texi(,5) @c % Copyright (C) 2004 Aaron S. Hawley ./my-bib-macros.texi(,6) ./my-bib-macros.texi(,7) @c % Author: Aaron S. Hawley ./my-bib-macros.texi(,8) @c % Keywords: docs, texinfo, extensions, bib ./my-bib-macros.texi(,9) ./my-bib-macros.texi(,10) @c % This file is free software; you can redistribute it and/or modify ./my-bib-macros.texi(,11) @c % it under the terms of the GNU General Public License as published by ./my-bib-macros.texi(,12) @c % the Free Software Foundation; either version 2, or (at your option) ./my-bib-macros.texi(,13) @c % any later version. ./my-bib-macros.texi(,14) ./my-bib-macros.texi(,15) @c % This file is distributed in the hope that it will be useful, ./my-bib-macros.texi(,16) @c % but WITHOUT ANY WARRANTY; without even the implied warranty of ./my-bib-macros.texi(,17) @c % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ./my-bib-macros.texi(,18) @c % GNU General Public License for more details. ./my-bib-macros.texi(,19) ./my-bib-macros.texi(,20) @c % You should have received a copy of the GNU General Public License ./my-bib-macros.texi(,21) @c % along with texi2html; see the file COPYING. If not, write to ./my-bib-macros.texi(,22) @c % the Free Software Foundation, Inc., 59 Temple Place - Suite 330, ./my-bib-macros.texi(,23) @c % Boston, MA 02111-1307, USA. ./my-bib-macros.texi(,24) ./my-bib-macros.texi(,25) @c %% Commentary: ./my-bib-macros.texi(,26) ./my-bib-macros.texi(,27) @c %%% Introduction ./my-bib-macros.texi(,28) ./my-bib-macros.texi(,29) @c %% Creates references to a ``Bibliography'' or ``References'' ./my-bib-macros.texi(,30) @c %% section of a Texinfo document, using Texinfo's ./my-bib-macros.texi(,31) @c %% macro system. Although not as terse a way to cite systems as is ./my-bib-macros.texi(,32) @c %% found in document systems like TeX, the format is simpler and ./my-bib-macros.texi(,33) @c %% the rendering is easier for non-academic readers. ./my-bib-macros.texi(,34) ./my-bib-macros.texi(,35) @c % ./my-bib-macros.texi(,36) ./my-bib-macros.texi(,37) @c %%% Usage ./my-bib-macros.texi(,38) ./my-bib-macros.texi(,39) @c %% References to cited works can be put in any section of a document. ./my-bib-macros.texi(,40) @c %% The cited works must be put in either a Texinfo table (for ./my-bib-macros.texi(,41) @c %% instance with ``@table @asis ... @end table'') or within a ./my-bib-macros.texi(,42) @c %% Texinfo list (something like ``@enumerate ... @end enumerate'' ./my-bib-macros.texi(,43) @c %% or ``@itemize @bullet ... @end itemize''). They are created ./my-bib-macros.texi(,44) @c %% with the command ``@mybibitem{REF-NAME}''. To cite a reference ./my-bib-macros.texi(,45) @c %% with a @mybibitem use ``@mybibcite{REF-NAME}''. ./my-bib-macros.texi(,46) ./my-bib-macros.texi(,47) @c %% The beginning of a document must include (using the @include ./my-bib-macros.texi(,48) @c %% command) the file my-bib-macros.texi, which should be made ./my-bib-macros.texi(,49) @c %% available in the current directory of the parent file. A single ./my-bib-macros.texi(,50) @c %% call should be made to choose to use a list or a table. The ./my-bib-macros.texi(,51) @c %% command to chose is called @mybibuselist{NODE}, where NODE is ./my-bib-macros.texi(,52) @c %% the node containing the location where the references are listed. ./my-bib-macros.texi(,53) ./my-bib-macros.texi(,54) @c % ./my-bib-macros.texi(,55) ./my-bib-macros.texi(,56) @c %%% Example ./my-bib-macros.texi(,57) ./my-bib-macros.texi(,58) @c %% \input texinfo @c -*-texinfo-*- ./my-bib-macros.texi(,59) @c %% @comment %**start of header ./my-bib-macros.texi(,60) @c %% @setfilename my-file-with-bib.info ./my-bib-macros.texi(,61) @c %% @settitle Texinfo with a Bibliography and References ./my-bib-macros.texi(,62) @c %% ./my-bib-macros.texi(,63) @c %% @include my-bib-macros.texi ./my-bib-macros.texi(,64) @c %% @mybibuselist{References} ./my-bib-macros.texi(,65) @c %% ./my-bib-macros.texi(,66) @c %% @comment %**end of header ./my-bib-macros.texi(,67) @c %% ./my-bib-macros.texi(,68) @c %% @node Top ./my-bib-macros.texi(,69) @c %% @top Top ./my-bib-macros.texi(,70) @c %% ./my-bib-macros.texi(,71) @c %% @menu ./my-bib-macros.texi(,72) @c %% * Introduction:: ./my-bib-macros.texi(,73) @c %% * @mybibnode{}:: ./my-bib-macros.texi(,74) @c %% ./my-bib-macros.texi(,75) @c %% @end menu ./my-bib-macros.texi(,76) @c %% ./my-bib-macros.texi(,77) @c %% @node Introduction ./my-bib-macros.texi(,78) @c %% @chapter Introduction ./my-bib-macros.texi(,79) @c %% ./my-bib-macros.texi(,80) @c %% The ability of a documentation format to make cross references to a ./my-bib-macros.texi(,81) @c %% bibliography, a feature of LaTeX @mybibcite{LaTeX2e}, isn't ./my-bib-macros.texi(,82) @c %% currently supported in Texinfo. ./my-bib-macros.texi(,83) @c %% ./my-bib-macros.texi(,84) @c %% @node @mybibnode{} ./my-bib-macros.texi(,85) @c %% @chapter References ./my-bib-macros.texi(,86) @c %% ./my-bib-macros.texi(,87) @c %% @itemize @asis ./my-bib-macros.texi(,88) @c %% ./my-bib-macros.texi(,89) @c %% @mybibitem{LaTeX2e} Leslie Lamport, LaTeX User's Guide and ./my-bib-macros.texi(,90) @c %% Reference Manual, 2nd edition, Addison-Wesley, Reading, ./my-bib-macros.texi(,91) @c %% Massachusetts, 1994. ./my-bib-macros.texi(,92) @c %% ./my-bib-macros.texi(,93) @c %% @end itemize ./my-bib-macros.texi(,94) @c %% ./my-bib-macros.texi(,95) @c %% @bye ./my-bib-macros.texi(,96) ./my-bib-macros.texi(,97) @c %% ./my-bib-macros.texi(,98) ./my-bib-macros.texi(,99) @c %% This example produces (in Info): ./my-bib-macros.texi(,100) ./my-bib-macros.texi(,101) @c %% 1 Introduction ./my-bib-macros.texi(,102) @c %% ************** ./my-bib-macros.texi(,103) @c %% ./my-bib-macros.texi(,104) @c %% The ability of a documentation format to make cross ./my-bib-macros.texi(,105) @c %% references to a bibliography, a feature of LaTeX (See item ./my-bib-macros.texi(,106) @c %% [LaTeX2e] in *Note LaTeX2e: References.), is not currently ./my-bib-macros.texi(,107) @c %% supported in Texinfo. ./my-bib-macros.texi(,108) @c %% ./my-bib-macros.texi(,109) @c %% ./my-bib-macros.texi(,110) @c %% 2 References ./my-bib-macros.texi(,111) @c %% ************ ./my-bib-macros.texi(,112) @c %% ./my-bib-macros.texi(,113) @c %% [LaTeX2e] Leslie Lamport, LaTeX User's Guide and Reference ./my-bib-macros.texi(,114) @c %% Manual, 2nd edition, Addison-Wesley, Reading, ./my-bib-macros.texi(,115) @c %% Massachusetts, 1994. ./my-bib-macros.texi(,116) ./my-bib-macros.texi(,117) @c %% and (in printed output): ./my-bib-macros.texi(,118) ./my-bib-macros.texi(,119) @c %% 1 Introduction ./my-bib-macros.texi(,120) @c %% ************** ./my-bib-macros.texi(,121) @c %% ./my-bib-macros.texi(,122) @c %% The ability of a documentation format to make cross ./my-bib-macros.texi(,123) @c %% references to a bibliography, a feature of LaTeX (See item ./my-bib-macros.texi(,124) @c %% [LaTeX2e] in Chapter 2 [References], page 3.), is not ./my-bib-macros.texi(,125) @c %% currently supported in Texinfo. ./my-bib-macros.texi(,126) @c %% ./my-bib-macros.texi(,127) @c %% ./my-bib-macros.texi(,128) @c %% 2 References ./my-bib-macros.texi(,129) @c %% ************ ./my-bib-macros.texi(,130) @c %% ./my-bib-macros.texi(,131) @c %% [LaTeX2e] Leslie Lamport, LaTeX User's Guide and Reference ./my-bib-macros.texi(,132) @c %% Manual, 2nd edition, Addison-Wesley, Reading, ./my-bib-macros.texi(,133) @c %% Massachusetts, 1994. ./my-bib-macros.texi(,134) ./my-bib-macros.texi(,135) @c % ./my-bib-macros.texi(,136) ./my-bib-macros.texi(,137) @c %%% Notes ./my-bib-macros.texi(,138) ./my-bib-macros.texi(,139) @c %% The pointers to references will be functional in hypertext ./my-bib-macros.texi(,140) @c %% documentation (info, HTML, XML and others) and properly rendered ./my-bib-macros.texi(,141) @c %% in print documents, because they are implemented with Texinfo's ./my-bib-macros.texi(,142) @c %% cross referencing capabilities (using @anchor and @ref). Failures ./my-bib-macros.texi(,143) @c %% by an author to make proper references with ``my-bib-macros'' in ./my-bib-macros.texi(,144) @c %% their document will give cross referencing errors by Texinfo ./my-bib-macros.texi(,145) @c %% conversion tools. ./my-bib-macros.texi(,146) ./my-bib-macros.texi(,147) @c %% Only one ``Reference'' section is allowed per document. ./my-bib-macros.texi(,148) ./my-bib-macros.texi(,149) @c %% An improvement of this system would create cross references ./my-bib-macros.texi(,150) @c %% (with @xref) at each cited work to all the originating cross ./my-bib-macros.texi(,151) @c %% refererences. ./my-bib-macros.texi(,152) ./my-bib-macros.texi(,153) @c % ./my-bib-macros.texi(,154) ./my-bib-macros.texi(,155) @c %% Code: ./my-bib-macros.texi(,156) ./my-bib-macros.texi(,157) @c % Configuration Options ./my-bib-macros.texi(,158) ./my-bib-macros.texi(,159) @c %% @mybibsetrefnode : Defines the name of the node to contain ./my-bib-macros.texi(,160) @c %% references. ./my-bib-macros.texi(,161) ./my-bib-macros.texi(,165) ./my-bib-macros.texi(,166) @c %% @mybibnode{} : Macro to be placed at node containing references ./my-bib-macros.texi(,167) @c %% and calls to @mybibcite{} ./my-bib-macros.texi(,168) ./my-bib-macros.texi(,172) ./my-bib-macros.texi(,173) @c %% @mybibusetable : Whether each @mybibitem will be put in a ./my-bib-macros.texi(,174) @c %% table. ./my-bib-macros.texi(,175) ./my-bib-macros.texi(,183) ./my-bib-macros.texi(,184) @c %% @mybibuselist : Whether each @mybibitem will be put in a ./my-bib-macros.texi(,185) @c %% list. ./my-bib-macros.texi(,186) ./my-bib-macros.texi(,194) ./my-bib-macros.texi(,195) ./my-bib-macros.texi(,196) @c %% @mybibcite{REF} : Cites the cross reference REF. ./my-bib-macros.texi(,197) ./my-bib-macros.texi(,208) ./my-bib-macros.texi(,212) ./my-bib-macros.texi(,213) @c %% @mybibcite{REF} : Creates a cross referenced citation REF. ./my-bib-macros.texi(,214) ./my-bib-macros.texi(,231) ./my-bib-macros.texi(,232) @c %% my-bib-macros.texi ends here bib-example.texi(mybibuselist,27) bib-example.texi(,28) bib-example.texi(,29) @comment %**end of header bib-example.texi(,30) bib-example.texi(,31) @node Top bib-example.texi(,32) @top Top bib-example.texi(,33) bib-example.texi(,34) @menu bib-example.texi(,35) * Introduction:: bib-example.texi(mybibnode,36) * bib-example.texi(mybibnode,36) Referencesbib-example.texi(mybibnode,36) :: bib-example.texi(,37) bib-example.texi(,38) @end menu bib-example.texi(,39) bib-example.texi(,40) @node Introduction bib-example.texi(,41) @chapter Introduction bib-example.texi(,42) bib-example.texi(,43) The ability of a documentation format to make cross references to a bib-example.texi(mybibcite,44) bibliography, a feature of LaTeX bib-example.texi(mybibcite,44) @c %**else if bib-example.texi(mybibcite,44) (See item [LaTeX2e] in @ref{References, LaTeX2e}.)bib-example.texi(mybibcite,44) bib-example.texi(mybibcite,44) , isn't bib-example.texi(,45) currently supported in Texinfo. bib-example.texi(,46) bib-example.texi(mybibnode,47) @node bib-example.texi(mybibnode,47) Referencesbib-example.texi(mybibnode,47) bib-example.texi(,48) @chapter References bib-example.texi(,49) bib-example.texi(,50) @itemize @asis bib-example.texi(,51) bib-example.texi(mybibitem,52) @item bib-example.texi(mybibitem,52) @anchor{LaTeX2e}[LaTeX2e] bib-example.texi(mybibitem,52) @c %**else if bib-example.texi(mybibitem,52) Leslie Lamport, LaTeX User's Guide and bib-example.texi(,53) Reference Manual, 2nd edition, Addison-Wesley, Reading, bib-example.texi(,54) Massachusetts, 1994. bib-example.texi(,55) bib-example.texi(,56) @end itemize bib-example.texi(,57) bib-example.texi(,58) @bye