validation/doc/cdoc.cdoc

///
// Title
// -----

///
// short description
int a(int param, int arg);

///
// short description
// longer description
int b(int param, int arg);

///
// short description
//
// longer description with empty line
int c(int param, int arg);

///
// short description
// longer description
// which needs two lines
int d(int param, int arg);

///
// short description
//
// longer description with empty line
// which needs two lines
int e(int param, int arg);

///
// condensed format
// @param: desc param
// @arg: desc arg
// @return: desc return
// longer description
int f(int param, int arg);

///
// more airy format
//
// @param: desc param
// @arg: desc arg
// @return: desc return
//
// longer description
int g(int param, int arg);

///
// short description
// @return: ``1`` if @param is zero,
//	``0`` otherwise.
int h(int param, int arg);

///
// short description
// @return:
//	* ``1`` if @param is zero,
//	* ``0`` otherwise.
int i(int param, int arg);

///
// short description
int m(int param, int arg)
{ return 0; }

///
// short description
int n(int param,
	int arg)
{ return 0; }

///
// short description
int o(int param, int arg);

///
// short description
int p(int param,
	int arg);


/*
 * check-name: cdoc
 * check-command: Documentation/sphinx/cdoc.py < $file
 *
 * check-output-start
   2: Title
   3: -----
   4: 
   4: 
   5: 
   7: .. c:function:: int a(int param, int arg)
   8: 
   6: 	Short description.
   7: 
  12: .. c:function:: int b(int param, int arg)
  13: 
  10: 	Short description.
  11: 
  11: 	longer description
  12: 
  18: .. c:function:: int c(int param, int arg)
  19: 
  15: 	Short description.
  16: 
  17: 	longer description with empty line
  18: 
  24: .. c:function:: int d(int param, int arg)
  25: 
  21: 	Short description.
  22: 
  22: 	longer description
  23: 	which needs two lines
  24: 
  31: .. c:function:: int e(int param, int arg)
  32: 
  27: 	Short description.
  28: 
  29: 	longer description with empty line
  30: 	which needs two lines
  31: 
  39: .. c:function:: int f(int param, int arg)
  40: 
  34: 	Condensed format.
  35: 
  35: 	:param param: desc param
  36: 	:param arg: desc arg
  37: 	:return: desc return
  38: 
  38: 	longer description
  39: 
  49: .. c:function:: int g(int param, int arg)
  50: 
  42: 	More airy format.
  43: 
  44: 	:param param: desc param
  45: 	:param arg: desc arg
  46: 	:return: desc return
  47: 
  48: 	longer description
  49: 
  55: .. c:function:: int h(int param, int arg)
  56: 
  52: 	Short description.
  53: 
  53: 	:return: ``1`` if **param** is zero,
  54: 		``0`` otherwise.
  54: 
  62: .. c:function:: int i(int param, int arg)
  63: 
  58: 	Short description.
  59: 
  59: 	:return: 
  60: 		* ``1`` if **param** is zero,
  61: 		* ``0`` otherwise.
  60: 
  66: .. c:function:: int m(int param, int arg)
  67: 
  65: 	Short description.
  66: 
  71: .. c:function:: int n(int param, int arg)
  72: 
  70: 	Short description.
  71: 
  77: .. c:function:: int o(int param, int arg)
  78: 
  76: 	Short description.
  77: 
  81: .. c:function:: int p(int param, int arg)
  82: 
  80: 	Short description.
  81: 
 * check-output-end
 */