Difference between revisions of "He/דוקסיג'ן"
From GnuCash
m (→כללי: fix link) |
m (→רכיבי דוקסיג'ן: typo) |
||
| (8 intermediate revisions by the same user not shown) | |||
| Line 4: | Line 4: | ||
{| class="wikitable" style="margin: auto;" | {| class="wikitable" style="margin: auto;" | ||
! scope="row"|שפות | ! scope="row"|שפות | ||
| − | |||
| [[{{PAGENAME:doxygen}}|English]] | | [[{{PAGENAME:doxygen}}|English]] | ||
| − | |||
| − | |||
| [[{{PAGENAME}}|עִברִית]] | | [[{{PAGENAME}}|עִברִית]] | ||
| − | |||
|} | |} | ||
| + | [[Category:He/פתוח]] [[Category:He/API]] [[Category:He/כלים]] | ||
==כללי== | ==כללי== | ||
לעת עתה [https://he.wikipedia.org/wiki/Doxygen דוקסיג'ן] הוא הכלי המרכזי שמשמש אותנו לתיעוד קוד המקור (ינואר 2011). | לעת עתה [https://he.wikipedia.org/wiki/Doxygen דוקסיג'ן] הוא הכלי המרכזי שמשמש אותנו לתיעוד קוד המקור (ינואר 2011). | ||
| − | + | התכנה שולפת מקוד המקור הערות (מיוחדות) שהוזנו על ידי המפתחים במהלך הקידוד, להפקת תיעוד הקוד. | |
| − | ; | + | ;בכול לילה: דוקסיג'ן מחולל אוטומטית, על בסיס קבוע, להשגת לזמינות מקוונת, לכתובת {{BuildServer}}/docs/ לשני הענפים: |
| − | :[{{BuildURL}}/docs/MAINT/ MAINT], תיקון | + | :[{{BuildURL}}/docs/MAINT/ MAINT], למאגר תיקון התקלים המישני הבא, ו־ |
| − | :[{{BuildURL}}/docs/MASTER/MASTER], השחרור העיקרי הבא. | + | :[{{BuildURL}}/docs/MASTER/ MASTER], מאגר השחרור העיקרי הבא. |
==יצירת תעוד המקור== | ==יצירת תעוד המקור== | ||
| Line 31: | Line 28: | ||
{{man note|1=חשוב|2=דורש התקנה של <tt>דוקסיג'ן</tt> במחשב. אחרת היעד <tt>doc</tt> לא יהיה זמין.}} | {{man note|1=חשוב|2=דורש התקנה של <tt>דוקסיג'ן</tt> במחשב. אחרת היעד <tt>doc</tt> לא יהיה זמין.}} | ||
| − | הרצת פקודות השורה הללו, יאכלסו את <tt>${BUILDDIR}/libgnucash/doc</tt>. בעיות ושגיאות ירשמו | + | הרצת פקודות השורה הללו, יאכלסו את <tt>${BUILDDIR}/libgnucash/doc</tt>. בעיות ושגיאות ירשמו ל־ <tt>doxygen.log</tt>. את קובצי ה־HTML ניתן יהיה למצוא בתת־התקיית ה־<tt>html</tt>. |
| − | קובץ ההתצור יווצר | + | קובץ ההתצור יווצר מ־<span dir="ltr"><tt>${SOURCEDIR}/libgnucash/doc/doxygen.cfg.in</tt></span>. |
==רכיבי דוקסיג'ן== | ==רכיבי דוקסיג'ן== | ||
| − | *ליצירת | + | *ליצירת הערה בסיגנון C, היא צריכה להתחיל ב־<tt>/**</tt> או <tt>/*!</tt>. |
*בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות <code><</code>, וכתוצאה מכך <tt>/**<</tt> או <tt>/*!<</tt>. | *בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות <code><</code>, וכתוצאה מכך <tt>/**<</tt> או <tt>/*!<</tt>. | ||
| − | *מילות מפתח דוקסיג'ן המתחילות | + | *מילות מפתח דוקסיג'ן המתחילות ב־<code>\</code> או <code>@</code>. |
| − | *לתיעוד | + | *לתיעוד עצמים כלליים, יש לתעד את הקובץ בו הם מוגדרים: |
<syntaxhighlight lang="C"> | <syntaxhighlight lang="C"> | ||
/*! \file */ | /*! \file */ | ||
| Line 67: | Line 64: | ||
:[https://github.com/doxygen/doxygen מאגר גיט] | :[https://github.com/doxygen/doxygen מאגר גיט] | ||
:[https://he.wikipedia.org/wiki/Doxygen עמוד ויקי] | :[https://he.wikipedia.org/wiki/Doxygen עמוד ויקי] | ||
| − | |||
Latest revision as of 11:53, 12 March 2022
| שפות | English | עִברִית |
|---|
כללי
לעת עתה דוקסיג'ן הוא הכלי המרכזי שמשמש אותנו לתיעוד קוד המקור (ינואר 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>
*/
