From d0ae56a96c2adb841643128f90c89eeaaa74651c Mon Sep 17 00:00:00 2001 From: Sebastian Geiger Date: Tue, 3 Jul 2018 21:12:58 +0200 Subject: [PATCH] help/manual: add paragraph about history --- help/manual/C/index.docbook | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/help/manual/C/index.docbook b/help/manual/C/index.docbook index 9cd2d80..bc23fad 100644 --- a/help/manual/C/index.docbook +++ b/help/manual/C/index.docbook @@ -254,8 +254,7 @@ Writing the documentation. The author fills in the source files with the documentation for each - function, macro, union etc. (In the past information was entered in - generated template files, which is not recommended anymore). + function, macro, structs or unions, etc. @@ -357,11 +356,21 @@ About GTK-Doc + Historically GTK-Doc was used to generate template files from the soures + code. These template files could be used by developers to enter the + API documentation. This approach was rather inconvenient because it + required to keep the generated files under version control. + Since GTK-Doc 1.9 it became possible to place all API information + into source comments, which made the template support obsolete. + In version 1.26 template support has been. + + + (FIXME) - (History, authors, web pages, mailing list, license, future plans, + (authors, web pages, mailing list, license, future plans, comparison with other similar systems.) -- 2.11.4.GIT