דוקסיג'ן (באנגלית: Doxygen /ד ɒ k s i dʒ ən / DOK -see-jən) הוא מחולל תיעוד, כלי לכתיבת תיעוד הפניה לשורות קוד בתכנה. התיעוד נכתב על ידי המתכנת (המקודד) בתוך מקטעי שורות הקוד במהלך התכנות, דבר שמאפשר שמירה על עדכניות התיעוד לגבי שינויים/תוספות שנעשו בתוכניות. דוקסיג'ן יכול להצליב תיעוד וקוד (כלומר, התיעוד שיחולץ משורות הקוד יכלול הפניה מדויקת למקור ממנו חולץ), כך שקורא מסמך התיעוד יכול להבין בקלות לאילו שורות קוד בפועל מפנה התיעוד.
הגרסה הראשונה של דוקסיג'ן 'השאילה' קוד מגרסה מוקדמת של ++DOC, חבילת תוכנה שפתחו רולנד וונדרלינג ומלטה זוקלר במכון Zuse Berlin. מאוחר יותר, שוכתב קוד דוקסיג'ן על ידי דימיטרי ואן היץ'.
דוקסיג'ן הוא תוכנה חופשית, המופץ בתנאי הרישיון הציבורי הכללי של גנו GNU GPL, גרסה 2.
עיצוב.
דוקסיג'ן (כמו גם Javadoc) מחלץ תיעוד 'מהערות' מלל שנכתבו בקובץ שורות קוד המקור. הוא תומך בתחביר וגם בתגי תיעוד המשמשים בערכת הכלים Qt.
דוקסיג'ן יכול להפיק פלט בשפת: HyperText Markup (HTML), , תבנית מלל עשיר (RTF), תבנית מסמך נייד (PDF), LaTeX, פוסטסקריפט או דפי .
שימושים.
דוקסיג'ן תומך במספר רב של שפות תכנות וביניהן: C, C ++, C #, D, Fortran, IDL, Java, Objective-C, Perl, PHP, Python ו- VHDL.
מאחר שדוקסיג'ן הוא למעשה חבילת קוד פתוח, המשמעות היא שעל ידי הוספת קוד עצמאי, ניתן להרחיב את התמיכה, על פי הצורך, גם לשפות תכנות נוספות.
דוקסיג'ן פועל ברוב מערכות ההפעלה: כול דמויי היוניקס לסוגיהם, MacOS ו-Windows.
אחת מהתכונות המובנות בדוקסיג'ן היא היכולת להפיק וירושה לשכבות שפת ++C, יכולת זו מאפשרת תצוגה חזותית של תלויות קוד ואובייקטי תכנה אלו באלו. על ידי שימוש בכלי 'dot' ו- . ניתן אף להרחיב את היכולות החזותיות של דוקסיג'ן להפקת דיאגרמות ותרשימים מתקדמים ביותר.
דוגמאות קוד.
התחביר הגנרי להוספת הערות תיעוד לתוך שורות הקוד, נעשה על ידי הוספת כוכבית נוספת לאחר תו התיחום ולפני תחילת הזנת ההערה '/*':
&lt;A short one line description&gt;
&lt;Longer description&gt;
&lt;May span multiple lines or paragraphs as needed&gt;
@param Description of method's or function's input parameter
@param ...
@return Description of the return value
לחלופין, ניתן גם לסמן התחלת שורה ברווח-כוכבית-רווח כדלקמן, אך אין זה הכרחי.
* &lt;A short one line description&gt;
* &lt;Longer description&gt;
* &lt;May span multiple lines or paragraphs as needed&gt;
* @param Description of method's or function's input parameter
* @param ...
* @return Description of the return value
תוכניתנים רבים נמנעים מלעשות שימוש בהערות בסגנון C ובמקום זאת משתמשים בהערות בשורה יחידה בסגנון ++C. דוקסיג'ן מזהה ומקבל גם הערות עם לוכסן ימני נוסף, כמו בדומה הבאה:
/// &lt;A short one line description&gt;
/// &lt;Longer description&gt;
/// &lt;May span multiple lines or paragraphs as needed&gt;
/// @param Description of method's or function's input parameter
/// @param ...
/// @return Description of the return value
הדוגמה הבאה מציגה את אופן תיעוד הערה בקובץ מקור בשפת ++C.
* @file
* @author John Doe &lt;jdoe@example.com&gt;
* @version 1.0
* @section LICENSE
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of
* the License, or (at your option) any later version.
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details at
* https://www.gnu.org/copyleft/gpl.html
* @section DESCRIPTION
* The time class represents a moment of time.
class Time {
public:
* Constructor that sets the time to a given value.
* @param timemillis is a number of milliseconds
* passed since Jan 1, 1970.
Time (int timemillis) {
// the code
* Get the current time.
* @return A time object set to the current time.
static Time now () {
// the code
גישה חלופית לתיעוד משתנים בשורות הקוד מוצגת להלן. תוצאת מבנה התיעוד תהיה זהה בשני המקרים.
* Constructor that sets the time to a given value.
Time (int timemillis ///&lt; Number of milliseconds passed since Jan 1, 1970.&gt;
// the code
אפשר גם להשתמש בשפת סימון עשירה יותר. לדוגמה, הוספת משוואות באמצעות פקודות LaTeX :
* An inline equation @f$ e^{\pi i}+1 = 0 @f$
* A displayed equation: @f[ e^{\pi i}+1 = 0 @f]
קוד מקור ופיתוח דוקסיג'ן.
את קוד המקור של דוקסיג'ן נתן למצוא ב-GitHub, דימיטרי ואן היץ', המפתח הראשי של דוקסיג'ן, תומך בחבילה וממשיך לתורם בהתפתחותה תחת שם המשתמש 'דוקסיג'ן'.
דוקסיג'ן כתוב בשפת ++C, וכולל למעלה מ-300,000 שורות קוד מקור. לניתוח מילולי, מופעל הכלי הסטנדרטי (או מחליפו Flex) על יותר מ-35,000 שורות של תסריטי . כלי ניתוח נוספים בהם נעשה שימוש:
הצי משתעשע
הצי משתעשע (באנגלית: Hit the Deck) הוא סרט מוזיקלי אמריקאי משנת 1955 בבימויו של רוי רולנד, עם ג'יין פאוול, אן מילר, דבי ריינולדס, ראס טמבלין, וולטר פידג'ן, טוני מרטין וויק דמון בתפקידים הראשיים.
התסריט וחלק מהשירים מבוססים על מחזמר בשם זה שהועלה בברודוויי ב-1927. העלילה דומה לזו של הסרטים המוזיקליים "יום בניו יורק" והרימו עוגן" - קבוצת מלחים מגיעים לעיר, מחפשים בידור ונפגשים/מתאהבים ברקדניות/זמרות.
פירוש הביטוי "Hit the Deck" הוא - התכונן לפעולה או פול על הקרקע/סיפון כדי להתגונן מהתקפה.
תקציר העלילה.
דני סמית' (ראס טמבלין), ריקו פרארי (ויק דאמון) ובילי קלארק (טוני מרטין) משרתים בצי ארצות הברית באלסקה. הם מקבלים פקודה לאפות עוגת פרידה למפקד היוצא. הם לא יודעים לאפות ומוצאים במטבח עוגה שלא נאפתה כראוי, עושים בה חורים וממלאים אותם ברום תוך כדי שירת "הללויה". המפקד מדליק את הנרות והעוגה עולה באש, על כך הם נענשים בשליחה לאימון במקום שורץ תנינים. לבסוף הם מגיעים לחופשה בסן פרנסיסקו.
בילי נפגש עם חברתו מזה שש שנים, ג'ינג'ר (אן מילר) שמופיעה כזמרת ורקדנית ורוצה לסיים את היחסים איתו לאחר שאינו רוצה להתחתן.
דני מגיע לביתו ונפגש עם אביו, תת-אדמירל דניאל סמית' (וולטר פידג'ן) שרוצה שדני ילך בדרכו כמו אבותיו. בבית נמצאת גם אחותו סוזי (ג'יין פאוול) שגם היא זמרת ורקדנית ורוצה להתקדם "בעזרתו" של המפיק רודף הנשים ונדל קרייג (ג'ין ריימונד).
דני פוגש בתיאטרון את הזמרת/רקדנית קרון פייס (דבי ריינולדס) ומתאהב בה.
ריקו (ויק דאמון) מבקר בבית אמו האלמנה (קיי ארמן) ופוגש שם את המחזר שלה מר פירנו (ג'. קרול נאייש) שאינו מוצא חן בעיניו.
קרייג מזמין לביתו את סוזן והיא שרה את "Sometimes I'm Happy" כשהוא מלווה אותה בפסנתר. כשהוא מחבק אותה והם מתנשקים, מתפרצים שלושת המלחים ומכים את קרייג ומשאירים לו "פנס" בעין. סוזן נמלטת משם וריקו מלווה אותה ומתאהב בה.
שוטרים צבאיים של הצי מחפשים אחריהם והם מתחבאים בביתו של ריקו ושרים עם אמו "צ'יריביריבין".
השוטרים מחפשים אותם והם מוצאים מסתור בתיאטרון שם מופיעה קרול ביחד עם "מלחים" ששרים ביחד "Join the Navy".
לבסוף מחליט קרייג לבטל את תלונתו כדי שהעניין לא יתפרסם ויתגלה לאשתו.
בסוף מופיעים כל משתתפי ההצגה במופע גדול ושרים ביחד "הללויה".
ריצ'רדסון (סייקלקאר 1919)
ריצ'רדסון (סייקלקאר 1919) (באנגלית: Richardson (1919 cyclecar)) היא מכונית פתוחה, מסוג סייקלקאר מתוצרת C. E. Richardson and Co אשר יוצרה בין השנים 1919–1921 בעיר שפילד בבריטניה.
ריצ'רדסון (סייקלקאר 1919).
לפני מלחמת העולם הראשונה רוכב האופניים הבריטי צ'ארלס אבנעזר ריצ'רדסון ייצר צעצועים וקטנועים לילדים והיה חלוץ של ייצור דגמי מטוסים. במהלך המלחמה המפעל עבר לייצור תחמושת. לאחר המלחמה הוחלט להסתעף לייצור מכוניות מסוג cyclecar שתוכננו על ידי אלברט קלארק, גיסו של צ'ארלס ריצ'רדסון.
הדגם היה פתוח, בתצורות של 2–4 מושבים.
המכונית הופעלה על ידי מנוע בנזין V-twin ומקורר אוויר עם מנועים של 980 סמ"ק או 1,090 סמ"ק. שתי יחידות הכוח נסעו דרך כונן חיכוך וחגורה עד לסרן האחורי. דגמים מאוחרים יותר השתמשו בכונן שרשרת.
במכוניות מוקדמות היה רדיאטור משופע בצורה חדה, אך זה השתנה לעיצוב אנכי מסוגנן יותר בשנת 1921.
סבורים כי כ-500 מכוניות יוצרו לפני שהייצור הופסק בשנת 1921.
Cyclecar.
Cyclecar הייתה סוג של מכונית קטנה, וזולה שיוצרה באירופה ובארצות הברית בין 1910 לתחילת שנות ה-20 של המאה ה-20. מטרתה של ה-Cyclecar הייתה למלא פער בשוק בין האופנוע לבין המכונית.
מועדון "Clubs Moto Cycliste" פרסם ב-14 בדצמבר 1912 תקנון לגבי מכוניות ה-"Cyclecar". הדגמים בקטגוריה של המכוניות הגדולות הוגבלו למשקל מקסימלי של 350 ק"ג ולמנוע בעל נפח עד 1,100 סמ"ק. הדגמים בקטגוריה של המכוניות הקטנות הוגבלו למשקל בין 150–300 ק"ג ולמנוע עד נפח 750 סמ"ק.
GraphQL