Hi Eric, Let's see if I'm a good proof-reader. Here are my comments, looking 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 block in Figure 1. Page 9 -- You say that "tags and properties of a node are inherited by its sub-nodes". I agree for tags, not for properties (at least, by default). Page 10 -- "Active code blocks are marked with a source line, followed by a name unique within the document". Why don't you call such "named code blocks" as in Babel's code base? BTW, what happens if there is a name clash with other code blocks (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 "collected from STDOUT incrementally"? Not sure about the added value of incrementally... Page 16 -- I find the name of the code block "ps-to-dot" very badly 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 textwidth. This is a more secure setting. Page 18 -- Is the default value of var (1 2 1) compliant with the "pass" table beneath it? Side comment -- Wouldn't you use a standard way of handling the acronyms in LaTeX, so that they're expanded when required, and listed at the end of the document? Example of such acro: ESS. For the rest, an excellent document, but not that good (IMHO) for publishing to a statistics journal. For doing so, I find you'd have to only include R examples, and show that you can do everything Sweave can do, and 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 much widen view. So, this is excellent, but for another audience. Best regards, Seb -- Sébastien 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
