Commit Graph

10 Commits

Author SHA1 Message Date
Jean Sirmai e8c3d13652 manual: WIP: elements of gem-graph theory (not yet translated from French) 2024-11-29 11:35:34 +01:00
Jean Sirmai 2754ef0de7 manual: migrate from plain text to texinfo
This commit creates docs/rtfm/gem-graph.texi, which from now on will be the
Gem-graph manual source code.

Its first text includes just an introduction, the beginning of a chapter namely
"Gem-graph by example" and a first cross-reference to the section "Hello world".
2024-11-29 11:34:25 +01:00
Jean Sirmai 1bcb74e3cb
src/util/* include/base.h makes available util_concat(), util_read_file()
introduces the enum axis { X_AXIS, Y_AXIS, Z_AXIS }

The use of util_concat() modifies the memory indirect leaks (not direct).
==23744== LEAK SUMMARY:
==23744==    definitely lost: 5,008 bytes in 54 blocks
==23744==    indirectly lost: 16,151 bytes in 673 blocks

Doc minor modifications (use __function_name__ instead of "function name").
2024-11-21 23:22:37 +01:00
Jean Sirmai f3564d0462
docs/rtfm/manual WIP: redaction
a version of the same text with lines length limited to 80 char is available
2024-11-20 17:59:09 +01:00
Jean Sirmai 05bb7c4ec2
src/widget/main_window/design First visible window (with memory leaks)
To display this minimal window, three files and two functions must be
added simultaneously:

- include/widget/h
- src/manager.c
- src/main_window/design.c

main() now contains: g_signal_connect (on_windows_activation);
on_windows_activation () is in src/manager.c and calls
widget_main_window () which is in src/main_window/design.c

NB  The iconic image of E coli drawn by David S. Goodsell in 2009
is reproduced here with permission.

One goal of Gem-graph is to animate such static representations
i.e. use the best anatomy to try to achieve good physiology.
2024-11-20 17:59:09 +01:00
Jean Sirmai 56acc696b6
docs/rtfm/intro writing + cleaning details in src/ 2024-11-20 17:59:09 +01:00
Jean Sirmai 2a739928fb
rtfm/intro (writing the manual) + cleaning doc 2024-11-20 17:59:09 +01:00
Jean Sirmai 98f69581b8
rtfm/intro Manual Introduction - a first version.
The same text is presented in two formats: for an external text editor (.txt)
or with lines limited to 80 characters.

The links are prepared but not functionnal.
2024-11-20 17:54:16 +01:00
Jean Sirmai 6e72f1f392
src/fsm/control.c fsm_init() and fsm_close() can be now triggered from main().
These two functions (defined in control.c) initiate the log and print it just
before the end of the program.
It is now possible to send messages that reports the events occuring during a
session: the creation of the log, then of the application and their closure in
the reverse order.
As previously,there is no g signal connect (activate) and no window is created.
This triggers the same error message in the console.
What is new, in this commit, is that a first log is printed in the console.
2024-11-20 17:54:16 +01:00
Jean Sirmai 1676f36674
docs/*: integrate doxygen, create a documentation zone, adds notes
We wanted to have an automated documentation for our project. We choose doxygen
since this is a well-established project, with common standards.

To generate the documentation, simply type `make docs` and open `docs/html/index.html`.

The documentation zone actually contains:
	- archives: several files from past of the projects, historical purpose
	- GTK-docs: ressources on GTK internals and API
	- rtfm: first draft of a user manual
	- showcase: some pictures of the UI example, that were communicated on the Gem-graph discussion room (XMPP)
	- html: doxygen-generated docs
2024-11-20 17:54:06 +01:00