doc/doxygen/doxygen_main_page.txt

/** \mainpage JSOC Reference

This is the developer and design manual for JSOC. Previous
documentation has been integrated into this and it should always be up
to date since it is generated directly from the source files using
Doxygen.

\section general General design documents

Start with the "ManPage Sections" tab for html versions of the JSOC software manual
pages.

General information on:\n
 - JSOC: http://jsoc.stanford.edu\n
 - HMI: http://hmi.stanford.edu\n
 - AIA: http://aia.lmsal.com\n

\section hacking Hacking on this documentation

There is the beginning of a style guide for documenting under
\ref tipshints.

There is an example module documentation man page at
\ref module_template.

Feel free to start documenting or playing with doxygen configuration.
This main page can be found in doc/doxygen_main_page.txt .

This main page is just an introduction to doxygen markup, see the
Doxygen manual for the full command set.

- \ref tipshints Tips and hints for using doxygen
- \ref reference Links to the Doxygen manual

*/
/** \page tipshints Useful tips for doxygen in C files

 - \ref reference The Doxygen manual

\section tips An introduction to doxygen markup

\subsection Locations What to document

All declarations for:

-# typedef
-# struct
-# enum
-# functions

This will enable doxygen to link all parameter types to the declarations
every time the type is used in a function - very helpful to new developers.

\subsection Files Private files

If your declarations are in separate files, like private header files,
a simple block can still be linked into doxygen as long as the file is
identified to doxygen using a '\\file' section:

 \\file filename.h\n
 \\brief one-liner summary of the file purpose\n
 \\author the usual copyright statement

\subsection Methods How to document

Every doxygen comment block starts with an adapted comment marker. 
You can use an extra slash /// or an extra asterisk. Blocks end
in the usual way. Doxygen accepts commands using a backslash.

To put a description with each function or structure, use '\\brief'
End the brief description with a blank line. The rest of the documentation will
then be shown in the body of the doxygen page.

Commands may begin with \\ or @

\subsection Presentation Extras

        -# Start a line with a hyphen to start a list - the indent determines the
nesting of the list:
                - To create a numbered list, use -# e.g. for a sublist:
                        -# start a numbered list
                - revert to previous list

        End the list with a blank line.
Use :: at the start of a function or structure to link to the page
for that function in the doxygen documentation. e.g.  ::qof_class_foreach

Use the param command to describe function parameters in the text.

Use the 'back reference' to document enumerator values:\n
enum testenum {\n
        enum_one **&lt; less than marker tells doxygen to use this line
                to document enum_one.

\subsection config Editing Doxygen configuration

To edit the doxygen configuration, you can use:
*
cd doc
*
vi doxygen_publ.cfg &

*/

/*! \page reference Doxygen reference documentation

The Doxygen web site (http://www.stack.nl/~dimitri/doxygen/) has a
complete user manual.  For the impatient, here are the most
interesting sections:

- How to write grouped documentation for files, functions, variables,
etc.: http://www.stack.nl/~dimitri/doxygen/grouping.html .  Do not
forget to add a file documentation block (\@file) at the top of your
file. Otherwise, none of the documentation in that file will appear
in the html output.

- List of the special commands you can use within your documentation
blocks: http://www.stack.nl/~dimitri/doxygen/commands.html
*/


///@defgroup a_programs Section 1. Programs, DRMS Modules, Shell Scripts

///  @defgroup common_main All JSOC Modules Common Interface
///  @ingroup a_programs

///  @defgroup drms_util DRMS Utilities
///  @ingroup a_programs

///  @defgroup su_apps Stanford University Applications
///  @ingroup a_programs
///      @defgroup su_admin Administrative Utilities 
///      @ingroup su_apps
///      @defgroup su_util General Utilities 
///      @ingroup su_apps
///      @defgroup su_migration Data Migration 
///      @ingroup su_apps
///      @defgroup su_export Data Export 
///      @ingroup su_apps
///      @defgroup su_lev0 Level Zero 
///      @ingroup su_apps
///      @defgroup su_util Utilities for MDI, HMI, etc. 
///      @ingroup su_apps

///@defgroup c_api Section 3. API Libraries
// @{
    /**
    @defgroup sum_api SUMS API functions
    @ingroup c_api
    */

    /**
    @defgroup core_api Core DRMS API functions
    @ingroup c_api
    */

    /**
    @defgroup full_api All DRMS API functions
    @ingroup c_api
    */
// @}

/**
@defgroup record_api Functions for working with records
@ingroup full_api
*/

/**
@defgroup segment_api Functions for working with segments
@ingroup full_api
*/

/**
@defgroup cmdparam_api Functions for working with DRMS command-line parameters
@ingroup full_api
*/

/** 
@defgorup binfile_api Function for working with binary files
@ingroup full_api
*/

/**
@defgroup defs_api Functions for working with definition-file strings 
@ingroup full_api
*/

/**
@defgroup env_api Functions for working with the connection to the database
@ingroup full_api
*/

/**
@defgroup keymap_api Functions for managing the mapping between internal and external keywords
@ingroup full_api
*/

/**
@defgroup keyword_api Functions for reading and writing keywords
@ingroup full_api
*/

/**
@defgroup link_api Functions for reading from links
@ingroup full_api
*/

/**
@defgroup names_api Functions for working with record-query strings
@ingroup full_api
*/
Revision:	1.20
Committed:	Mon Oct 12 20:42:19 2009 UTC (13 years, 11 months ago) by phil
Content type:	text/plain
Branch:	MAIN
CVS Tags:	Ver_6-0, Ver_6-1, Ver_6-2, Ver_6-3, Ver_6-4, Ver_5-6, Ver_LATEST, NetDRMS_Ver_8-12, Ver_9-41, Ver_DRMSLATEST, Ver_9-5, Ver_9-4, Ver_9-3, Ver_9-2, Ver_9-1, Ver_9-0, NetDRMS_Ver_2-2, NetDRMS_Ver_2-3, NetDRMS_Ver_2-0, NetDRMS_Ver_2-1, NetDRMS_Ver_2-6, NetDRMS_Ver_2-7, NetDRMS_Ver_2-4, NetDRMS_Ver_2-5, NetDRMS_Ver_LATEST, NetDRMS_Ver_8-8, NetDRMS_Ver_8-10, NetDRMS_Ver_8-11, NetDRMS_Ver_8-4, NetDRMS_Ver_8-5, NetDRMS_Ver_8-6, NetDRMS_Ver_8-7, NetDRMS_Ver_8-0, NetDRMS_Ver_8-1, NetDRMS_Ver_8-2, NetDRMS_Ver_8-3, Ver_8-8, Ver_8-2, Ver_8-3, Ver_8-0, Ver_8-1, Ver_8-6, Ver_8-7, Ver_8-4, Ver_8-5, Ver_5-7, Ver_7-0, Ver_5-9, Ver_5-8, Ver_8-10, Ver_8-11, Ver_8-12, NetDRMS_Ver_6-4, NetDRMS_Ver_6-2, NetDRMS_Ver_6-3, NetDRMS_Ver_6-0, NetDRMS_Ver_6-1, Ver_5-14, Ver_5-13, Ver_5-12, Ver_5-11, Ver_5-10, NetDRMS_Ver_9-9, NetDRMS_Ver_9-41, NetDRMS_Ver_9-1, NetDRMS_Ver_9-0, NetDRMS_Ver_9-3, NetDRMS_Ver_9-2, NetDRMS_Ver_9-5, NetDRMS_Ver_9-4, Ver_7-1, NetDRMS_Ver_7-1, NetDRMS_Ver_7-0, HEAD
Changes since 1.19:	+2 -0 lines
Log Message:	add su_util group for MDI, HMI, etc general purpose utility programs.
#	Content
1	/** \mainpage JSOC Reference
2
3	This is the developer and design manual for JSOC. Previous
4	documentation has been integrated into this and it should always be up
5	to date since it is generated directly from the source files using
6	Doxygen.
7
8	\section general General design documents
9
10	Start with the "ManPage Sections" tab for html versions of the JSOC software manual
11	pages.
12
13	General information on:\n
14	- JSOC: http://jsoc.stanford.edu\n
15	- HMI: http://hmi.stanford.edu\n
16	- AIA: http://aia.lmsal.com\n
17
18	\section hacking Hacking on this documentation
19
20	There is the beginning of a style guide for documenting under
21	\ref tipshints.
22
23	There is an example module documentation man page at
24	\ref module_template.
25
26	Feel free to start documenting or playing with doxygen configuration.
27	This main page can be found in doc/doxygen_main_page.txt .
28
29	This main page is just an introduction to doxygen markup, see the
30	Doxygen manual for the full command set.
31
32	- \ref tipshints Tips and hints for using doxygen
33	- \ref reference Links to the Doxygen manual
34
35	*/
36	/** \page tipshints Useful tips for doxygen in C files
37
38	- \ref reference The Doxygen manual
39
40	\section tips An introduction to doxygen markup
41
42	\subsection Locations What to document
43
44	All declarations for:
45
46	-# typedef
47	-# struct
48	-# enum
49	-# functions
50
51	This will enable doxygen to link all parameter types to the declarations
52	every time the type is used in a function - very helpful to new developers.
53
54	\subsection Files Private files
55
56	If your declarations are in separate files, like private header files,
57	a simple block can still be linked into doxygen as long as the file is
58	identified to doxygen using a '\\file' section:
59
60	\\file filename.h\n
61	\\brief one-liner summary of the file purpose\n
62	\\author the usual copyright statement
63
64	\subsection Methods How to document
65
66	Every doxygen comment block starts with an adapted comment marker.
67	You can use an extra slash /// or an extra asterisk. Blocks end
68	in the usual way. Doxygen accepts commands using a backslash.
69
70	To put a description with each function or structure, use '\\brief'
71	End the brief description with a blank line. The rest of the documentation will
72	then be shown in the body of the doxygen page.
73
74	Commands may begin with \\ or @
75
76	\subsection Presentation Extras
77
78	-# Start a line with a hyphen to start a list - the indent determines the
79	nesting of the list:
80	- To create a numbered list, use -# e.g. for a sublist:
81	-# start a numbered list
82	- revert to previous list
83
84	End the list with a blank line.
85	Use :: at the start of a function or structure to link to the page
86	for that function in the doxygen documentation. e.g. ::qof_class_foreach
87
88	Use the param command to describe function parameters in the text.
89
90	Use the 'back reference' to document enumerator values:\n
91	enum testenum {\n
92	enum_one **< less than marker tells doxygen to use this line
93	to document enum_one.
94
95	\subsection config Editing Doxygen configuration
96
97	To edit the doxygen configuration, you can use:
98	*
99	cd doc
100	*
101	vi doxygen_publ.cfg &
102
103	*/
104
105	/*! \page reference Doxygen reference documentation
106
107	The Doxygen web site (http://www.stack.nl/~dimitri/doxygen/) has a
108	complete user manual. For the impatient, here are the most
109	interesting sections:
110
111	- How to write grouped documentation for files, functions, variables,
112	etc.: http://www.stack.nl/~dimitri/doxygen/grouping.html . Do not
113	forget to add a file documentation block (\@file) at the top of your
114	file. Otherwise, none of the documentation in that file will appear
115	in the html output.
116
117	- List of the special commands you can use within your documentation
118	blocks: http://www.stack.nl/~dimitri/doxygen/commands.html
119	*/
120
121
122	///@defgroup a_programs Section 1. Programs, DRMS Modules, Shell Scripts
123
124	/// @defgroup common_main All JSOC Modules Common Interface
125	/// @ingroup a_programs
126
127	/// @defgroup drms_util DRMS Utilities
128	/// @ingroup a_programs
129
130	/// @defgroup su_apps Stanford University Applications
131	/// @ingroup a_programs
132	/// @defgroup su_admin Administrative Utilities
133	/// @ingroup su_apps
134	/// @defgroup su_util General Utilities
135	/// @ingroup su_apps
136	/// @defgroup su_migration Data Migration
137	/// @ingroup su_apps
138	/// @defgroup su_export Data Export
139	/// @ingroup su_apps
140	/// @defgroup su_lev0 Level Zero
141	/// @ingroup su_apps
142	/// @defgroup su_util Utilities for MDI, HMI, etc.
143	/// @ingroup su_apps
144
145	///@defgroup c_api Section 3. API Libraries
146	// @{
147	/**
148	@defgroup sum_api SUMS API functions
149	@ingroup c_api
150	*/
151
152	/**
153	@defgroup core_api Core DRMS API functions
154	@ingroup c_api
155	*/
156
157	/**
158	@defgroup full_api All DRMS API functions
159	@ingroup c_api
160	*/
161	// @}
162
163	/**
164	@defgroup record_api Functions for working with records
165	@ingroup full_api
166	*/
167
168	/**
169	@defgroup segment_api Functions for working with segments
170	@ingroup full_api
171	*/
172
173	/**
174	@defgroup cmdparam_api Functions for working with DRMS command-line parameters
175	@ingroup full_api
176	*/
177
178	/**
179	@defgorup binfile_api Function for working with binary files
180	@ingroup full_api
181	*/
182
183	/**
184	@defgroup defs_api Functions for working with definition-file strings
185	@ingroup full_api
186	*/
187
188	/**
189	@defgroup env_api Functions for working with the connection to the database
190	@ingroup full_api
191	*/
192
193	/**
194	@defgroup keymap_api Functions for managing the mapping between internal and external keywords
195	@ingroup full_api
196	*/
197
198	/**
199	@defgroup keyword_api Functions for reading and writing keywords
200	@ingroup full_api
201	*/
202
203	/**
204	@defgroup link_api Functions for reading from links
205	@ingroup full_api
206	*/
207
208	/**
209	@defgroup names_api Functions for working with record-query strings
210	@ingroup full_api
211	*/