sphinx.ext.oldcmarkup – Compatibility extension for old C markup

优质
小牛编辑
130浏览
2023-12-01

New in version 1.0.

This extension is a transition helper for projects that used the old (pre-domain) C markup, i.e. the directives like cfunction and roles like cfunc. Since the introduction of domains, they must be called by their fully-qualified name (c:function and c:func, respectively) or, with the default domain set to c, by their new name (function and func). (See The C Domain for the details.)

If you activate this extension, it will register the old names, and you can use them like before Sphinx 1.0. The directives are:

  • cfunction
  • cmember
  • cmacro
  • ctype
  • cvar

The roles are:

  • cdata
  • cfunc
  • cmacro
  • ctype

However, it is advised to migrate to the new markup – this extension is a compatibility convenience and will disappear in a future version of Sphinx.