* Adam D. Barratt <adam@adam-barratt.org.uk>, 2010-08-30, 16:06:
Please unblock package sphinx. The new version improves documentation (bug #593623).A couple of quick comments: +\fIfilename\fR +Force to generate documentation for the file. "Force to" doesn't sound right - "Force generation of documentation for \fIfilename\fR." ?
Agreed. (Note that this is not a regression, 0.6.6-2 includes the same sentence.)
+Define the \fItag\fR. This is relevant for \[oq]only\[cq] directives that only include their content if this tag is set. That sentence appears to contain too many "only"s; ah, does it mean that it's only relevant for directives that would not include their content if the tag were not set? If so then I'd suggest changing the start to "This is only relevant for directives that"
Okay, this is a bit confusing. The first "only" refers to the name of a directive: http://sphinx.pocoo.org/latest/markup/misc.html#directive-only
-- Jakub Wilk
Attachment:
signature.asc
Description: Digital signature