From 587e847bb3768663e67185bf8606c0250368225f Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 30 Nov 2008 00:21:14 +0000 Subject: qobitree update (29nov08) git-svn-id: svn://tug.org/texlive/trunk@11472 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/qobitree/README | 109 ++++++++++++++++++++++ Master/texmf-dist/doc/latex/qobitree/example.dvi | Bin 11452 -> 0 bytes Master/texmf-dist/doc/latex/qobitree/example.tex | 16 ++++ Master/texmf-dist/doc/latex/qobitree/readme | 92 ------------------ Master/texmf-dist/tex/latex/qobitree/qobitree.tex | 16 ++++ 5 files changed, 141 insertions(+), 92 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/qobitree/README delete mode 100644 Master/texmf-dist/doc/latex/qobitree/example.dvi delete mode 100644 Master/texmf-dist/doc/latex/qobitree/readme (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/qobitree/README b/Master/texmf-dist/doc/latex/qobitree/README new file mode 100644 index 00000000000..5da48e9eaa0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/qobitree/README @@ -0,0 +1,109 @@ +Copyright 1996 Jeffrey Mark Siskind + +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 (at your option) 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 `unmaintained'. + +This work consists of all files listed in manifest.txt. + +Copyright and licensing notice added 2008/11/29 by +Clea F. Rees on behalf of Jeffrey Mark Siskind. + +While writing my PhD thesis, I put together some useful LaTeX macros for +typesetting trees. I thought that they would be of general interest so I am +making them available. I gave an earlier version of these macros to Phil +Resnik a few months ago. These new macros are much easier to use and produce +much nicer output. For arcane reasons, the new macros, however, use a +different calling sequence. To use the new package get the file +~qobi/tex/QobiTree/QobiTree.tex from unagi and put in wherever you put your TeX +macros. Put the line: + +\input{QobiTree} + +somewhere at the beginning of your LaTeX file. The tree macros operate like a +stack machine. You push TeX boxes onto the stack containing text for the nodes +of the tree and then you pop them off the make branching nodes which get +pushed back on the stack. The following commands are supported: + +\leaf{} + +Pushes a node onto the stack containing . The can contain +`\\' commands to create a node with more than one line. For example: + +\leaf{NP\\{\em John}} + +creates a two line node with NP (in roman) on top of John (in italics). +You can put any TeX box inside a leaf node, including math mode, LaTeX +picture environments, tables, embedded postscript, and other trees. +QobiTree automatically figures out how big the node is and sizes the tree and +its branches accordingly. + +The command: + +\branch{n}{} + +pops n nodes off the stack and creates a branching node with n children and +pushes it back on the stack. The first node popped off becomes the rightmost +child and the last node popped off becomes the leftmost child. n must be an +integer between 1 and 5. (It is possible to extend QobiTree to handle trees of +greater branching factor. See me if you need to.) The branching node created +is given as its label. Again can have `\\' commands and can be +any TeX box. For example: + +\leaf{NP\\{\em John}} +\leaf{V\\{\em saw}} +\leaf{NP\\{\em Mary}} +\branch{2}{VP\\{em saw Mary}} +\branch{2}{S\\{\em John saw Mary}} + +creates a simple binary branching tree. + +The \leaf and \branch command don't generate any typeset output. They just +push trees onto the stack. The output is generated with the following command: + +\tree + +which pops one node off the stack and typesets it as a single box. Usually you +would center this box as in: + +\leaf{NP\\{\em John}} +\leaf{V\\{\em saw}} +\leaf{NP\\{\em Mary}} +\branch{2}{VP\\{em saw Mary}} +\branch{2}{S\\{\em John saw Mary}} +\begin{center} +\tree +\end{center} + +but it is also possible to put a tree in a sentence, in a table, in a math +mode formula, in a picture environment, or in another tree. +The file ~qobi/tex/QobiTree/examples.tex contains some examples taken +from my thesis. + +Most of the time, QobiTree does a good job of figuring out how to space the +children of a tree. It never mistakingly overlaps children. Unlike the earlier +version of the tree macros I gave Phil, it is usually able to space the tree +better without inordinate growth in deep trees. Sometimes however, you can +give it some help to produce even better looking output. The command: + +\faketreewidth{} + +tells QobiTree to override its default calculation of the width of the node on +the top of the stack and replace it with the width of (which again can +have `\\' commands etc.) is not actually typeset but is used just to +compute the fake width of the node on the top of the stack. When you use +\faketreewidth you are on your own. This can either shrink or enlarge the +space taken by the node and may result in trees with overlapping children. +Usually a few tries with xdvi and you can adjust the tree widths to produce +the desired output. See ~qobi/tex/QobiTree/examples.tex for some +examples using \faketreewidth. + +I hope that people find these macros useful. Feel free to pass them on to +whoever wants them. + Jeff diff --git a/Master/texmf-dist/doc/latex/qobitree/example.dvi b/Master/texmf-dist/doc/latex/qobitree/example.dvi deleted file mode 100644 index 9da0ff25329..00000000000 Binary files a/Master/texmf-dist/doc/latex/qobitree/example.dvi and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/qobitree/example.tex b/Master/texmf-dist/doc/latex/qobitree/example.tex index 505749d7d2a..4155175c4c5 100644 --- a/Master/texmf-dist/doc/latex/qobitree/example.tex +++ b/Master/texmf-dist/doc/latex/qobitree/example.tex @@ -1,3 +1,19 @@ +%% Copyright 1996 Jeffrey Mark Siskind +% +% 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 (at your option) 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 `unmaintained'. +% +% This work consists of all files listed in manifest.txt. +% +%% Copyright and licensing notice added 2008/11/29 by +%% Clea F. Rees on behalf of Jeffrey Mark Siskind. %% Datum: 27.06.95 %% Datum: 22.06.95 %% Datum: 22.06.95 diff --git a/Master/texmf-dist/doc/latex/qobitree/readme b/Master/texmf-dist/doc/latex/qobitree/readme deleted file mode 100644 index f96298c1458..00000000000 --- a/Master/texmf-dist/doc/latex/qobitree/readme +++ /dev/null @@ -1,92 +0,0 @@ -While writing my PhD thesis, I put together some useful LaTeX macros for -typesetting trees. I thought that they would be of general interest so I am -making them available. I gave an earlier version of these macros to Phil -Resnik a few months ago. These new macros are much easier to use and produce -much nicer output. For arcane reasons, the new macros, however, use a -different calling sequence. To use the new package get the file -~qobi/tex/QobiTree/QobiTree.tex from unagi and put in wherever you put your TeX -macros. Put the line: - -\input{QobiTree} - -somewhere at the beginning of your LaTeX file. The tree macros operate like a -stack machine. You push TeX boxes onto the stack containing text for the nodes -of the tree and then you pop them off the make branching nodes which get -pushed back on the stack. The following commands are supported: - -\leaf{} - -Pushes a node onto the stack containing . The can contain -`\\' commands to create a node with more than one line. For example: - -\leaf{NP\\{\em John}} - -creates a two line node with NP (in roman) on top of John (in italics). -You can put any TeX box inside a leaf node, including math mode, LaTeX -picture environments, tables, embedded postscript, and other trees. -QobiTree automatically figures out how big the node is and sizes the tree and -its branches accordingly. - -The command: - -\branch{n}{} - -pops n nodes off the stack and creates a branching node with n children and -pushes it back on the stack. The first node popped off becomes the rightmost -child and the last node popped off becomes the leftmost child. n must be an -integer between 1 and 5. (It is possible to extend QobiTree to handle trees of -greater branching factor. See me if you need to.) The branching node created -is given as its label. Again can have `\\' commands and can be -any TeX box. For example: - -\leaf{NP\\{\em John}} -\leaf{V\\{\em saw}} -\leaf{NP\\{\em Mary}} -\branch{2}{VP\\{em saw Mary}} -\branch{2}{S\\{\em John saw Mary}} - -creates a simple binary branching tree. - -The \leaf and \branch command don't generate any typeset output. They just -push trees onto the stack. The output is generated with the following command: - -\tree - -which pops one node off the stack and typesets it as a single box. Usually you -would center this box as in: - -\leaf{NP\\{\em John}} -\leaf{V\\{\em saw}} -\leaf{NP\\{\em Mary}} -\branch{2}{VP\\{em saw Mary}} -\branch{2}{S\\{\em John saw Mary}} -\begin{center} -\tree -\end{center} - -but it is also possible to put a tree in a sentence, in a table, in a math -mode formula, in a picture environment, or in another tree. -The file ~qobi/tex/QobiTree/examples.tex contains some examples taken -from my thesis. - -Most of the time, QobiTree does a good job of figuring out how to space the -children of a tree. It never mistakingly overlaps children. Unlike the earlier -version of the tree macros I gave Phil, it is usually able to space the tree -better without inordinate growth in deep trees. Sometimes however, you can -give it some help to produce even better looking output. The command: - -\faketreewidth{} - -tells QobiTree to override its default calculation of the width of the node on -the top of the stack and replace it with the width of (which again can -have `\\' commands etc.) is not actually typeset but is used just to -compute the fake width of the node on the top of the stack. When you use -\faketreewidth you are on your own. This can either shrink or enlarge the -space taken by the node and may result in trees with overlapping children. -Usually a few tries with xdvi and you can adjust the tree widths to produce -the desired output. See ~qobi/tex/QobiTree/examples.tex for some -examples using \faketreewidth. - -I hope that people find these macros useful. Feel free to pass them on to -whoever wants them. - Jeff diff --git a/Master/texmf-dist/tex/latex/qobitree/qobitree.tex b/Master/texmf-dist/tex/latex/qobitree/qobitree.tex index edcc9a2de35..32b4386fadb 100644 --- a/Master/texmf-dist/tex/latex/qobitree/qobitree.tex +++ b/Master/texmf-dist/tex/latex/qobitree/qobitree.tex @@ -1,3 +1,19 @@ +%% Copyright 1996 Jeffrey Mark Siskind +% +% 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 (at your option) 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 `unmaintained'. +% +% This work consists of all files listed in manifest.txt. +% +%% Copyright and licensing notice added 2008/11/29 by +%% Clea F. Rees on behalf of Jeffrey Mark Siskind. % % QobiTree tree macros written by Jeffrey Mark Siskind (Qobi@CIS.UPenn.EDU) % -- cgit v1.2.3