From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Jason Rumney Newsgroups: gmane.emacs.devel Subject: Re: Error in xml.el documentation Date: Fri, 22 Feb 2008 22:30:23 +0000 Message-ID: <47BF4CFF.6040303@gnu.org> References: <47BF3438.1070707@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1203719484 11414 80.91.229.12 (22 Feb 2008 22:31:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 22 Feb 2008 22:31:24 +0000 (UTC) Cc: Emacs Devel To: "Lennart Borgman (gmail)" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Feb 22 23:31:49 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JSgQm-0005r6-1k for ged-emacs-devel@m.gmane.org; Fri, 22 Feb 2008 23:31:48 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JSgQG-0007QH-A4 for ged-emacs-devel@m.gmane.org; Fri, 22 Feb 2008 17:31:16 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JSgPW-0007Hd-P3 for emacs-devel@gnu.org; Fri, 22 Feb 2008 17:30:30 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JSgPV-0007Gq-6E for emacs-devel@gnu.org; Fri, 22 Feb 2008 17:30:30 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JSgPU-0007Gf-R9 for emacs-devel@gnu.org; Fri, 22 Feb 2008 17:30:28 -0500 Original-Received: from mk-outboundfilter-3.mail.uk.tiscali.com ([212.74.114.23]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JSgPU-0004Uc-Py for emacs-devel@gnu.org; Fri, 22 Feb 2008 17:30:28 -0500 Original-X-Trace: 46707129/mk-outboundfilter-1.mail.uk.tiscali.com/F2S/$ACCEPTED/freedom2Surf-customers/83.67.23.108 X-SBRS: None X-RemoteIP: 83.67.23.108 X-IP-MAIL-FROM: jasonr@gnu.org X-IP-BHB: Once X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AgAAALbbvkdTQxds/2dsb2JhbAAIjDaiYQ X-IP-Direction: OUT Original-Received: from i-83-67-23-108.freedom2surf.net (HELO [127.0.0.1]) ([83.67.23.108]) by smtp.f2s.tiscali.co.uk with ESMTP/TLS/DHE-RSA-AES256-SHA; 22 Feb 2008 22:30:26 +0000 User-Agent: Thunderbird 2.0.0.9 (Windows/20071031) In-Reply-To: <47BF3438.1070707@gmail.com> X-detected-kernel: by monty-python.gnu.org: Genre and OS details not recognized. X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:90029 Archived-At: Lennart Borgman (gmail) wrote: > The documentation at the top of xml.el says > > ;; There can be only top level node, but with any number of children > below. > > I think it should be "only one top level node" and > Yes. > ;; The functions `xml-parse-file', `xml-parse-region' and > ;; `xml-parse-tag' return a list with the following format: > ;; > ;; xml-list ::= (node node ...) This one is correct. The functions mentioned return a list of nodes. In the case of xml-parse-region at least, there can be more than one node at the top level of the returned list.