Re: Documentation/scsi/aha152x.rst

[Randy Dunlap <rdunlap@infradead.org>]

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