From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kevin Ryde Newsgroups: gmane.emacs.devel Subject: Re: bindat docs on length of str, strz, etc types Date: Sat, 30 Dec 2006 09:42:06 +1100 Message-ID: <87ejqiz5mp.fsf@zip.com.au> References: <87r6ulq8qs.fsf@zip.com.au> <87irfwrjtq.fsf@zip.com.au> NNTP-Posting-Host: dough.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1167432200 27173 80.91.229.10 (29 Dec 2006 22:43:20 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 29 Dec 2006 22:43:20 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 29 23:43:17 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by dough.gmane.org with esmtp (Exim 4.50) id 1H0QRV-0008Lt-4n for ged-emacs-devel@m.gmane.org; Fri, 29 Dec 2006 23:43:13 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H0QRU-00013B-MD for ged-emacs-devel@m.gmane.org; Fri, 29 Dec 2006 17:43:12 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1H0QQY-0008Qv-1o for emacs-devel@gnu.org; Fri, 29 Dec 2006 17:42:14 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1H0QQV-0008Nh-RZ for emacs-devel@gnu.org; Fri, 29 Dec 2006 17:42:13 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H0QQV-0008NO-KL for emacs-devel@gnu.org; Fri, 29 Dec 2006 17:42:11 -0500 Original-Received: from [61.8.2.215] (helo=mailout1.pacific.net.au) by monty-python.gnu.org with esmtp (Exim 4.52) id 1H0QQV-0002Qb-2S for emacs-devel@gnu.org; Fri, 29 Dec 2006 17:42:11 -0500 Original-Received: from mailproxy2.pacific.net.au (mailproxy2.pacific.net.au [61.8.2.163]) by mailout1.pacific.net.au (Postfix) with ESMTP id B542F5A7C53; Sat, 30 Dec 2006 09:42:05 +1100 (EST) Original-Received: from localhost (ppp2283.dyn.pacific.net.au [61.8.34.131]) by mailproxy2.pacific.net.au (Postfix) with ESMTP id 337772740D; Sat, 30 Dec 2006 09:42:05 +1100 (EST) Original-Received: from gg by localhost with local (Exim 4.63) (envelope-from ) id 1H0QQQ-0001jX-WE; Sat, 30 Dec 2006 09:42:07 +1100 Original-To: storm@cua.dk (Kim F. Storm) In-Reply-To: (Kim F. Storm's message of "Fri, 29 Dec 2006 02:23:08 +0100") User-Agent: Gnus/5.110006 (No Gnus v0.6) Emacs/21.4 (gnu/linux) 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:64452 Archived-At: storm@cua.dk (Kim F. Storm) writes: > > I have now updated the bindat docs according to your suggestions. > Please have a look. I'm unsure about this bit In this case, the length can be given either by that field's name as specified for `bindat-get-field' Should it say you write "(fieldname)" instead of a bare name. Perhaps if the "([NAME] HANDLER)" bit was at the start of the section you could refer back to that instead of forward to bindat-get-field too. Also maybe an @multitable could show the possibilities better than words. I suspect it's one of those things where patterns or examples are easier to follow than actual description. :) integer fixed given length (FIELDNAME) length from a previous field (eval FORM) length from evaluating FORM (more on eval below)