From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Thomas S. Dye" Subject: Re: Re: Org-mode Code Blocks Manuscript: Request For Comments Date: Wed, 8 Dec 2010 06:33:29 -1000 Message-ID: <8A39D48A-22E7-46D5-A7F3-0B5C0C1621F5@tsdye.com> References: <87lj487z50.fsf@gmail.com> <12760.1291360577@gamaville.dokosmarshall.org> <80k4jl2ny3.fsf@missioncriticalit.com> Mime-Version: 1.0 (Apple Message framework v936) Content-Type: text/plain; charset=ISO-8859-1; format=flowed; delsp=yes Content-Transfer-Encoding: quoted-printable Return-path: Received: from [140.186.70.92] (port=59376 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PQMxT-0000ys-5y for emacs-orgmode@gnu.org; Wed, 08 Dec 2010 11:33:36 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PQMxS-0008Gv-3F for emacs-orgmode@gnu.org; Wed, 08 Dec 2010 11:33:35 -0500 Received: from cpoproxy3-pub.bluehost.com ([67.222.54.6]:35056) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1PQMxR-0008Go-Mi for emacs-orgmode@gnu.org; Wed, 08 Dec 2010 11:33:34 -0500 In-Reply-To: <80k4jl2ny3.fsf@missioncriticalit.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: =?ISO-8859-1?Q?S=E9bastien_Vauban?= Cc: emacs-orgmode@gnu.org Aloha Seb, Thanks for your detailed and thorough review. Your comments will help =20= us revise the paper. Much appreciated. All the best, Tom On Dec 7, 2010, at 12:55 PM, S=E9bastien Vauban wrote: > Hi Eric, > > Let's see if I'm a good proof-reader. Here are my comments, looking =20= > at things > not already said by others: > > Page 1 -- "... desirable to mix prose, (add input data?,) code, and > computational results." > > Page 3 -- It'd be better not to have commas in front of the Org-mode =20= > block in > Figure 1. > > Page 9 -- You say that "tags and properties of a node are inherited =20= > by its > sub-nodes". I agree for tags, not for properties (at least, by =20 > default). > > Page 10 -- "Active code blocks are marked with a source line, =20 > followed by a > name unique within the document". Why don't you call such "named =20 > code blocks" > as in Babel's code base? > > BTW, what happens if there is a name clash with other code blocks =20 > (in the same > document, or in the LOB)? Though, this is not for your paper... > > Page 12 -- When results is set to output, what do you mean by =20 > "collected from > STDOUT incrementally"? Not sure about the added value of =20 > incrementally... > > Page 16 -- I find the name of the code block "ps-to-dot" very badly =20= > chosen. PS > makes me think of PostScript, while you mean here Pascal's triangle... > > Page 17 -- In the LaTeX ATTR, better use linewidth instead of =20 > textwidth. This > is a more secure setting. > > Page 18 -- Is the default value of var (1 2 1) compliant with the =20 > "pass" table > beneath it? > > Side comment -- Wouldn't you use a standard way of handling the =20 > acronyms in > LaTeX, so that they're expanded when required, and listed at the end =20= > of the > document? Example of such acro: ESS. > > For the rest, an excellent document, but not that good (IMHO) for =20 > publishing > to a statistics journal. For doing so, I find you'd have to only =20 > include R > examples, and show that you can do everything Sweave can do, and =20 > even much > more. But I would focus on stats a lot more than it is here. > > But, the way it is written, it is much more general, and offers a =20 > much widen > view. So, this is excellent, but for another audience. > > Best regards, > Seb > > --=20 > S=E9bastien Vauban > > > _______________________________________________ > Emacs-orgmode mailing list > Please use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode