[cffi-devel] [patch] cffi-sys-spec Texinfo idioms

Stephen Compall s11 at member.fsf.org
Mon Dec 19 19:47:25 UTC 2005


http://csserver.evansville.edu/~sc87/cffi/cffi-sys-spec.texinfo.1s11.patch is the patch, also attached.

http://csserver.evansville.edu/~sc87/cffi/ChangeLog.cffi-sys-spec.texinfo.1s11 is a changelog, formatted as ChangeLog-luis is in the tarballs directory.  Its contents also follow.

Please let me know if there is a better/preferred way to do this,
particularly as I am unfamiliar with darcs.

Mon Dec 19 13:34:00 CST 2005  Stephen Compall <s11 at member.fsf.org>
  * CFFI-SYS-SPEC manual updates & Texinfo idioms

  - Use @var for arguments, rather than @code.
  - Use @deftpx for a chain of type defns, rather than repeated @deftp
    blocks.
  - Use @result{} instead of explicit =>.
  - Use @r with appropriate formatting for comments in
    @examples/@lisps.
  - Introduction: Convert naming convention to a list of general
    conventions, and define "foreign type".
  - Rename the pointer functions.
  - Document new functions.
  - Use new @impnote macro to add notes, so they can be conditionally
    removed from the manual.

-- 
Stephen Compall
http://scompall.nocandysw.com/blog
-------------- next part --------------
A non-text attachment was scrubbed...
Name: cffi-sys-spec.texinfo.1s11.patch
Type: text/x-patch
Size: 13382 bytes
Desc: not available
URL: <https://mailman.common-lisp.net/pipermail/cffi-devel/attachments/20051219/43a3a8c2/attachment.bin>


More information about the cffi-devel mailing list