X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=man%2Fread.nexus.Rd;h=5594e0e21c424f33b98ccb29031120aaaed75197;hb=2014b83971be4b9cd1644d6127837df798e9335c;hp=a517e8991ab156510612f5c80fd6d86cde105ee9;hpb=1090d5990d4b6f7feb10c87638f4229f53891eb7;p=ape.git

diff --git a/man/read.nexus.Rd b/man/read.nexus.Rd
index a517e89..5594e0e 100644
--- a/man/read.nexus.Rd
+++ b/man/read.nexus.Rd
@@ -8,7 +8,8 @@ read.nexus(file, tree.names = NULL)
   \item{file}{a file name specified by either a variable of mode character,
     or a double-quoted string.}
   \item{tree.names}{if there are several trees to be read, a vector of
-    mode character that gives names to the individual trees.}
+    mode character giving names to the individual trees (by default,
+    this uses the labels in the NEXUS file if these are present).}
 }
 \description{
   This function reads one or several trees in a NEXUS file.
@@ -18,8 +19,7 @@ read.nexus(file, tree.names = NULL)
   NEXUS standard (but see the restriction below on TRANSLATION
   tables). Only the block ``TREES'' is read; the other data can be read
   with other functions (e.g., \code{\link{read.dna}},
-  \code{\link[utils]{read.table}}, ...). A trace of the original data is
-  kept with the attribute \code{"origin"} (see below).
+  \code{\link[utils]{read.table}}, \dots).
 
   If a TRANSLATION table is present it is assumed that only the tip
   labels are translated and they are all translated with integers
@@ -39,40 +39,14 @@ read.nexus(file, tree.names = NULL)
   message is issued.
 }
 \value{
-  an object of class \code{"phylo"} with the following components:
-  \item{edge}{a two-column matrix of mode character where each row
-    represents an edge of the tree; the nodes and the tips are
-    symbolized with numbers (these numbers are not treated as numeric,
-    hence the mode character); the nodes are represented with negative
-    numbers (the root being \code{"-1"}), and the tips are represented with
-    positive numbers. For each row, the first column gives the
-    ancestor. This representation allows an easy manipulation of the
-    tree, particularly if it is rooted.}
-  \item{edge.length}{a numeric vector giving the lengths of the
-    branches given by \code{edge}.}
-  \item{tip.label}{a vector of mode character giving the names of the
-    tips; the order of the names in this vector corresponds to the
-    (positive) number in \code{edge}.}
-  \item{node.label}{(optional) a vector of mode character giving the
-    names of the nodes (set to \code{NULL} if not available in the file).}
-  \item{root.edge}{(optional) a numeric value giving the length of the
-    branch at the root is it exists (\code{NULL} otherwise).}
-
-  If several trees are read in the file, the returned object is of class
-  \code{"multiPhylo"}, and is a list of objects of class \code{"phylo"}.
-
-  An attribute \code{"origin"} is further given to the returned object
-  which gives the name of the source file (with its path). This is used
-  to write a tree in a NEXUS file where all the original data must be
-  written (not only the tree) in accordance to the specifications of
-  Maddison et al. (1997).
+  an object of class \code{"phylo"} or of class \code{"multiPhylo"}.
 }
 \references{
   Maddison, D. R., Swofford, D. L. and Maddison, W. P. (1997) NEXUS: an
   extensible file format for systematic information. \emph{Systematic
     Biology}, \bold{46}, 590--621.
 }
-\author{Emmanuel Paradis \email{Emmanuel.Paradis@mpl.ird.fr}}
+\author{Emmanuel Paradis}
 \seealso{
   \code{\link{read.tree}}, \code{\link{write.nexus}},
   \code{\link{write.tree}}, \code{\link{read.nexus.data}},