On 7/29/20 10:16 AM, Julia Lawall wrote:
> Hello,
>
> The ada152 documentation mentions some compilation flags. This was
> converted to ReST as eg:
>
> +- DAUTOCONF
> + use configuration the controller reports (AHA-152x only)
>
> --DAUTOCONF
> - use configuration the controller reports (AHA-152x only)
>
> This is clearly not correct. The - should be attached to the D, and not
> be converted to a bullet. I tried replacing:
>
> - DAUTOCONF
>
> by
>
> - -DAUTOCONF
>
> but the result with rst2html was not very satisfactory. The DAUTOCONF
> seems to be slightly raised with respect to the rest of the text. And a
> subsequent case:
>
> - DSETUP0="{ IOPORT, IRQ, SCSI_ID, RECONNECT, PARITY, SYNCHRONOUS, DELAY, EXT_TRANS }"
>
> comes out different from the ones that have no associated list of possible
> values (larger letters, different font).
>
> What should be done instead?
>
> Also, does the kernel include some scripts for testing the documentation?
> make Documentation/scsi/aha152x.html doesn't seem to work.
I would do this:
$ make SPHINXDIRS="scsi" htmldocs
to limit the htmldocs build to Documentation/scsi/.
I don't know of a way to build only one output file.
--
~Randy
