Commit Graph

241 Commits

Author SHA1 Message Date
Don Cross
7eb88d30b3 Added documentation for Astronomy_Elongation. Added support for bullet lists. 2019-06-04 11:38:53 -04:00
Don Cross
35dcf2c403 Documented C function Astronomy_AngleFromSun. 2019-06-03 21:47:29 -04:00
Don Cross
83ec1a6b1a Fixed #43 - Trim trailing whitespace from source code before processing it.
This resolves an issue that sometimes messed up generating
markdown from C source code via doxygen and custom script hydrogen.js.
2019-06-03 15:08:10 -04:00
Don Cross
79c3c5a956 Discovered that trailing whitespace causes problems in doxygen on Windows.
I'm not sure exactly whether it is Windows versus Linux,
or just different versions of doxygen, but on my Windows laptop
I was getting messed up doxygen output. It turns out that everything
is back on track once I cleaned up all the trailing whitespace in
template/astronomy.c.  I will need to automate this in the future.
2019-06-03 14:45:40 -04:00
Don Cross
318ea259dc Fixed a typo in the documentation for Astronomy_Seasons. 2019-06-03 14:19:16 -04:00
Don Cross
60e2644f8f Added documentation for C function Astronomy_Seasons.
Also modified hydrogen.js to enclose function parameter names
inside a code block.
2019-06-03 14:13:24 -04:00
Don Cross
bf4ec1b057 Added documentation for C function Astronomy_Search. 2019-06-02 21:07:42 -04:00
Don Cross
a80d4899f3 Added documentation for C function Astronomy_EclipticLongitude. 2019-06-02 16:11:17 -04:00
Don Cross
abda37086d Added documentation for C function Astronomy_Ecliptic. 2019-06-02 16:01:48 -04:00
Don Cross
c03d12952e Eliminate potential thread-safety problem in Astronomy_Ecliptic.
Hardcode the mean obliquity of the ecliptic at J2000 instead of lazy-evaluating it.
This change eliminates a potential thread-safety issue.
2019-06-02 15:44:32 -04:00
Don Cross
1744b7c72e Added documentation for C function Astronomy_SunPosition. 2019-06-02 15:33:12 -04:00
Don Cross
5a9550b8db Added documentation for C function Astronomy_Horizon. 2019-06-02 14:34:53 -04:00
Don Cross
4bb1c73c10 C: replace magic numbers with enumerated types. Added documentation.
The following functions had parameters that accepted cryptic numeric values:

    Astronomy_GeoVector
    Astronomy_Equator
    Astronomy_SearchRiseSet

Replaced such parameters with enumerations. Added the following enumerated types:

    astro_aberration_t
    astro_direction_t
    astro_equator_date_t

Added more C documentation.
2019-06-02 13:34:30 -04:00
Don Cross
2e638da314 More work on C documentation. Tweaks to JS documentation. 2019-06-02 11:45:45 -04:00
Don Cross
1054042330 Added more documentation of C functions. 2019-06-01 22:10:28 -04:00
Don Cross
c6845c2d58 Generate documentation for C typedefs. 2019-06-01 21:00:58 -04:00
Don Cross
5bcaad1ac3 Added tables of contents with links to sections. 2019-06-01 20:27:16 -04:00
Don Cross
ee83dde084 Use code blocks for enum type names. 2019-06-01 20:07:48 -04:00
Don Cross
1091cc9ea7 Nope, trying to add links to enum values did not work. 2019-06-01 19:47:31 -04:00
Don Cross
2153e12181 Experiment with adding intra-document links to enum values.
I have a feeling this won't work, but at least I should try it.
2019-06-01 19:42:06 -04:00
Don Cross
14ba63eab5 hydrogen: Documenting C enumeration types. 2019-06-01 18:24:17 -04:00
Don Cross
83190bab8a hydrogen: Make parameter table header names consistent. 2019-06-01 16:24:24 -04:00
Don Cross
a1fe941837 hydrogen: generating markdown for C function parameter doxygen comments. 2019-06-01 16:22:43 -04:00
Don Cross
3f39cafb2f Include comma separated list of function parameter names. 2019-06-01 15:24:59 -04:00
Don Cross
6526adb540 More formatting improvements. 2019-05-31 21:05:18 -04:00
Don Cross
957550f716 Improve style of struct descriptions in C documentation. 2019-05-31 20:47:31 -04:00
Don Cross
848cf18a21 Style tweak for C function documentation. 2019-05-31 20:46:06 -04:00
Don Cross
95cb34fce5 hydrogen: More work on documenting C functions. 2019-05-31 20:40:42 -04:00
Don Cross
5c110eef8e hydrogen: Do not use code block for function prototypes: too ugly! 2019-05-31 19:44:33 -04:00
Don Cross
c8d56881bd Starting to generate markdown for C function prototypes. 2019-05-31 18:02:49 -04:00
Don Cross
afbec20b79 Link to other types from tables describing struct members. 2019-05-30 21:40:43 -04:00
Don Cross
64b513b67f More work on C documentation processor. 2019-05-30 21:28:50 -04:00
Don Cross
515e32a5ee Fixed internal links to symbols. Fixed some typos. 2019-05-30 21:19:03 -04:00
Don Cross
937789e9b4 Render descriptions of structs in C documentation. 2019-05-30 21:12:58 -04:00
Don Cross
01220ed5aa Add space before paragraph elements. 2019-05-30 20:55:29 -04:00
Don Cross
fd16d8d58c Make type column come before member column in struct tables.
It makes more sense for the C documentation of structs to
have the type come first, then the struct member name,
because it reads more like actual C code that way.
2019-05-30 20:48:04 -04:00
Don Cross
07b2d6e9b4 Another attempt to fix markdown boldface. 2019-05-30 20:45:51 -04:00
Don Cross
fd03142462 Experiment to get boldface tags working in kramdown. 2019-05-30 20:43:58 -04:00
Don Cross
abea7fe720 Giving up on using html paragraphs inside kramdown tables for now. 2019-05-30 20:35:30 -04:00
Don Cross
ca87caaac5 Another attempt to get kramdown and github to both render paragraphs inside tables. 2019-05-30 20:20:49 -04:00
Don Cross
5c258c5f2b Third attempt to get html to render correctly on github.com and gh-pages. 2019-05-30 17:56:50 -04:00
Don Cross
1938c2ab98 Second attempt to prevent gh-pages (kramdown) escaping html inside tables. 2019-05-30 17:54:21 -04:00
Don Cross
de42c967d7 Trying to get html to render correctly inside tables in gh-pages. 2019-05-30 17:46:53 -04:00
Don Cross
c8a0300ac0 hydrogen: trying to format paragraphs within tables. 2019-05-30 17:19:01 -04:00
Don Cross
ae201d1db6 Needed another blank line after the last structure table. 2019-05-30 15:57:58 -04:00
Don Cross
77d1b8d9c4 Total guessing game trying to get Markdown tables to render.
I don't understand the weird differences between rendering rules
on github.io and github.com. Maybe table headers need to begin
with capital letters?
2019-05-30 15:50:54 -04:00
Don Cross
645e00b7bf one more attempt to get structure tables rendering. 2019-05-30 15:45:44 -04:00
Don Cross
2e720df94c Update C documentation. 2019-05-30 15:44:45 -04:00
Don Cross
d26fa48d44 hydrogen: Starting to render Markdown for structure fields. 2019-05-30 15:40:38 -04:00
Don Cross
65e380e59c Trying to get tables to render on github.com; adding headers. 2019-05-28 21:30:45 -04:00