Difference between revisions of "He/דוקסיג'ן"
From GnuCash
(→רכיבי דוקסיג'ן) |
|||
| Line 41: | Line 41: | ||
*בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות <code><</code>, וכתוצאה מכך <tt>/**<</tt> או <tt>/*!<</tt>. | *בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות <code><</code>, וכתוצאה מכך <tt>/**<</tt> או <tt>/*!<</tt>. | ||
*מלות מפתח דוקסיג'ן המתחילות ב- <code>\</code> או <code>@</code>. | *מלות מפתח דוקסיג'ן המתחילות ב- <code>\</code> או <code>@</code>. | ||
| − | *לתיעוד אובייקטים כליליים, יש לתעד את הקובץ בו הם מוגדרים:<syntaxhighlight lang="C"> | + | *לתיעוד אובייקטים כליליים, יש לתעד את הקובץ בו הם מוגדרים: |
| + | <syntaxhighlight lang="C"> | ||
/*! \file */ | /*! \file */ | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 10:57, 7 April 2021
| שפות | Deutsch | English | Español | Français | עִברִית | Português |
|---|
כללי
דוקסיג'ן הוא המוקד המרכזי לתיעוד קוד המקור לעת עתה (ינואר 2011). תכנה זו שולפת הערות (מיוחדות) מקוד המקור להפקת תיעוד הקוד.
- כול לילה
- מחולל אוטומטית לזמינות מקוונת על בסיס קבוע בכתובת code.gnucash.org/docs/ לשני הענפים:
- MAINT, תקון תקלים מישני הבא, ו-
- MASTER, השחרור העיקרי הבא.
יצירת תעוד המקור
ניתן להרצה מהעותק המקומי במחשב שלכם באמצעות הפקודה:
make doc
או במידה והבניה נעשת על ידיד ninja:
ninja doc
- חשוב
- דורש התקנה של דוקסיג'ן במחשב. אחרת היעד doc לא יהיה זמין.
הרצת פקודות השורה הללו, יאכלסו את ${BUILDDIR}/libgnucash/doc. בעיות ושגיאות ירשמו ל- doxygen.log. את קובצי ה- HTML ניתן יהיה למצוא בתת-התקייתב- html.
קובץ ההתצור יווצר מ- ${SOURCEDIR}/libgnucash/doc/doxygen.cfg.in.
רכיבי דוקסיג'ן
- ליצירת הערכה בסיגנון C, היא צריכה להתחיל ב- /** או /*!.
- בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות
<, וכתוצאה מכך /**< או /*!<. - מלות מפתח דוקסיג'ן המתחילות ב-
\או@. - לתיעוד אובייקטים כליליים, יש לתעד את הקובץ בו הם מוגדרים:
/*! \file */
- או
/** @file */
שיפור תיעוד המקור
קובץ כותרת עם API ציבורי חייב לכלול את מקטעי דוקסיג'ן הבאים:/**
* @addtogroup <module>
* @{
* @file
* @brief <A brief description>
* @author Copyright (C) <year> <name> <email>
*/
