Doxygen. Bogdan Kreczmer. bogdan.kreczmer@pwr.wroc.pl



Podobne dokumenty
Doxygen. Bogdan Kreczmer. ZPCiR ICT PWr pokój 307 budynek C3.

Praca z aplikacją designer

Zasoby, pliki graficzne

Qt sygnały i designer

Qt sygnały i sloty. Bogdan Kreczmer. Katedra Cybernetyki i Robotyki Wydział Elektroniki Politechnika Wrocławska

Wprowadzenie do szablonów klas

Papyrus. Papyrus. Katedra Cybernetyki i Robotyki Politechnika Wrocławska

Dokumentacja i systemy jako±ci

Schemat konstrukcja pliku Makefile

Weryfikatory, zasoby graficzne

Kurs programowania. Wykład 7. Wojciech Macyna. 25 kwietnia 2017

Szablony funkcji i szablony klas

Wprowadzenie do UML, przykład użycia kolizja

Zasady Programowania (Projektowanie) C++ - część 3 1/17 Doxygen - wprowadzenie

Javadoc. Piotr Dąbrowiecki Sławomir Pawlewicz Alan Pilawa Joanna Sobczyk Alina Strachocka

Język JAVA podstawy. wykład 1, część 2. Jacek Rumiński. Politechnika Gdańska, Inżynieria Biomedyczna

Zad. 5: Sterowanie robotem mobilnym

Przykłady oprogramowania wykorzystujacego Qt

Język Java część 2 (przykładowa aplikacja)

Wybrane narzędzia wspomagające dokumentowanie programu

Cechy systemu X Window: otwartość niezależność od producentów i od sprzętu, dostępny kod źródłowy; architektura klient-serwer;

Zad. 5: Układ równań liniowych liczb zespolonych

Dalmierze optyczne. Bogdan Kreczmer.

Diagramy UML, przykład problemu kolizji

Dariusz Brzeziński. Politechnika Poznańska, Instytut Informatyki

Język Java część 2 (przykładowa aplikacja)

Sphinx - system dokumentacji dla Pythona

Programowanie obiektowe

Java jako język programowania

Pola i metody statyczne

Programowanie niskopoziomowe

Tworzenie dokumentacji

Wyliczanie wyrażenia obiekty tymczasowe

Przestrzenie nazw. Bogdan Kreczmer. Katedra Cybernetyki i Robotyki Politechnika Wrocławska

Zad. 6: Sterowanie robotem mobilnym

1.Wstęp. 2.Generowanie systemu w EDK

Programowanie obiektowe zastosowanie języka Java SE

Tworzenie pliku źródłowego w aplikacji POLTAX2B.

WOJEWÓDZTWO PODKARPACKIE

Wizualizacja pogody dla windsurferów

Produkcja by CTI. Proces instalacji, ważne informacje oraz konfiguracja

UML a kod w C++ i Javie. Przypadki użycia. Diagramy klas. Klasy użytkowników i wykorzystywane funkcje. Związki pomiędzy przypadkami.

Wyjątki. Wyjątki. Bogdan Kreczmer. Katedra Cybernetyki i Robotyki Politechnika Wrocławska

Wykład 5 Okna MDI i SDI, dziedziczenie

Modelowanie obiektowe - Ćw. 1.

- Narzędzie Windows Forms. - Przykładowe aplikacje. Wyższa Metody Szkoła programowania Techniczno Ekonomiczna 1 w Świdnicy

WYKONANIE APLIKACJI OKIENKOWEJ OBLICZAJĄCEJ SUMĘ DWÓCH LICZB W ŚRODOWISKU PROGRAMISTYCZNYM. NetBeans. Wykonał: Jacek Ventzke informatyka sem.

Implementacja aplikacji sieciowych z wykorzystaniem środowiska Qt

Instrukcja instalacji i konfiguracji czytników kart kryptograficznych, aplikacji procertum CardManager, obsługa aplikacji procertum CardManager w

Oprogramowanie i wykorzystanie stacji roboczych. Wykład 4

Tworzenie oprogramowania

16) Wprowadzenie do raportowania Rave

Zad. 7: Fabryka obiektów i singleton

Produkcja by CTI. Proces instalacji, ważne informacje oraz konfiguracja

Zad. 7: Fabryka obiektów i singleton

Instalacja programu:

Programowanie w Javie

Aktyn - W Płace-Kadry Pro SQL E-DEKLARACJE

KATEGORIA OBSZAR WIEDZY

Aplikacja npodpis do obsługi certyfikatu

Symfonia Produkcja. Kreator raportów. Wersja 2013

Wprowadzenie do szablonów szablony funkcji

S P I S T R E Ś C I. Instrukcja obsługi

GStreamer. Bogdan Kreczmer. Katedra Cybernetyki i Robotyki Wydziału Elektroniki Politechnika Wrocławska

WPROWADZENIE DO INFORMATYKI

Synchronizator plików (SSC) - dokumentacja

Budowa aplikacji z graficznym interfejsem użytkownika - GUI (Graphic User Interface)

Zaawansowane programowanie w języku C++ Programowanie obiektowe

OpenGL oświetlenie. Bogdan Kreczmer. Katedra Cybernetyki i Robotyki Wydziału Elektroniki Politechnika Wrocławska

Sposoby tworzenia projektu zawierającego aplet w środowisku NetBeans. Metody zabezpieczenia komputera użytkownika przed działaniem apletu.

Operacje wejścia/wyjścia odsłona pierwsza

Jak utworzyć diagram

Materiały oryginalne: ZAWWW-2st1.2-l11.tresc-1.0kolor.pdf. Materiały poprawione

MentorGraphics ModelSim

Aplikacja npodpis do obsługi certyfikatu

Style programowania - krótki przeglad

Ćwiczenie Nr 6 Przegląd pozostałych najważniejszych mechanizmów systemu operacyjnego Windows

Aplikacja npodpis do obsługi certyfikatu

HELIOS pomoc społeczna

Programator Kart Master - klient

Wstęp do Informatyki i Programowania Laboratorium: Lista 0 Środowisko programowania

Wprowadzenie do Doctrine ORM

Laboratorium 1 Temat: Przygotowanie środowiska programistycznego. Poznanie edytora. Kompilacja i uruchomienie prostych programów przykładowych.

Zadanie1: Odszukaj w serwisie internetowym Wikipedii informacje na temat protokołu http.

finiownia loginów. W zależności od ustawionej opcji użytkownik login:

Wprowadzenie do szablonów szablony funkcji

etrader Pekao Podręcznik użytkownika Strumieniowanie Excel

TEMAT : KLASY DZIEDZICZENIE

Tworzenie i obsługa wirtualnego laboratorium komputerowego

Baza danych i ORM mgr Tomasz Xięski, Instytut Informatyki, Uniwersytet Śląski Katowice, 2011

Transkrypt:

najważniejsze cechy Bogdan Kreczmer bogdan.kreczmer@pwr.wroc.pl Zakład Podstaw Cybernetyki i Robotyki Instytut Informatyki, Automatyki i Robotyki Politechnika Wrocławska Kurs: Copyright c 2013 Bogdan Kreczmer Niniejszy dokument zawiera materiały do wykładu dotyczącego programowania obiektowego. Jest on udostępniony pod warunkiem wykorzystania wyłącznie do własnych prywatnych potrzeb i może on być kopiowany wyłącznie w całości, razem z niniejszą stroną tytułową.

najważniejsze cechy Niniejsza prezentacja została wykonana przy użyciu systemu składu L A TEX oraz stylu beamer, którego autorem jest Till Tantau. Strona domowa projektu Beamer: http://latex-beamer.sourceforge.net

najważniejsze cechy 1 najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 2

Plan prezentacji najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 1 najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 2

Krótko o doxygen najważniejsze cechy Ogólna charakterystyka Praca programu doxygen Autor projektu: Dimitri van Heesch Strona projektu: http://www.doxygen.org jest systemem dokumentowania oprogramowania pisanego w C++, C, Java, Objective-C, Python, IDL, Fortran, VHDL, PHP, C# oraz D. System ten może generować dokumentację w HTML oraz źródła dla L A TEX a. Dokumentacja może mieć format RTF (MS-Word), PostScript, PDF (z hyper-łącznikami), skompresowanego HTML oraz stron podręcznika w systemie UNIX dla programu man. Dokumentacja może być generowana bezpośrednio ze źródeł, jak też plików stowarzyszonych z nimi. jest programem tworzonym dla systemu Linux i Mac OS w oparciu o bibliotekę Qt (doxywizard). Oprogramowanie to jest przenośne. Może być uruchomione pod systemem UNIX i jego klonami. Dostępne jest również w postaci binarnej dla systemu MS Windows.

najważniejsze cechy Ogólna charakterystyka Praca programu doxygen Projekty zdokumentowane z użyciem doxygen Obecnie ponad 377 bardziej znanych projektów wykorzystuje system doxygen do generowania dokumentacji. Jedne z bardziej znanych to: Adobe Open Source strona domowa projektów ASL (Adobe Source Libraries). KDE - dokumentacja różnych bibliotek. Samba OSCAR (http://www.oscar-net.org) tworzy ogólną architekturę dla syrstemów robotycznych z ukierunkowaniem na roboty mobilne. XEngine (http://xengine.sourceforge.net) silnik dla wizualizacji 3D w czasie rzeczywistym, jest on niezależny od platformy i typu API wykorzystywanego renderowania. Xerces C++ Parser biblioteka umożliwiająca pisanie aplikacji, które wymagają parsera plików XML.

najważniejsze cechy Ogólna charakterystyka Praca programu doxygen Przykładowe systemy tworzenia dokumentacji Niekomercyjne: AutoDOC Cocoon CcDoc Autoduck Natural Docs HappyDoc Doc++ Epydoc RoboDoc phpdocumentor C2HTML CppDoc KDoc ScanDoc HeaderDoc HyperSQL Javadoc Tydoc Synopsis Cxx2HTML DocClass gtk-doc Cxref Perceps ReThree-C++ PHPDoc cxxwrap VBDOX HTMLgen Komercyjne: CC-Rider Doc-o-matic Together VBXC DocJet ObjectManual DocBuilder

Plan prezentacji najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 1 najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 2

najważniejsze cechy kompnenty Ogólna charakterystyka Praca programu doxygen doxygen - program generujący dokumentację na podstawie utworzonego wcześniej pliku konfiguracyjnego i przeglądanych plików (źródeł programów i nie tylko). doxytag - program pomocniczy pozwalający integrować zewnętrzną dokumentację (do której doxygen nie ma bezpośredniego dostępu) z dokumentacją tworzoną przez doxygen. doxywizard - graficzna aplikacja ułatwiająca tworzenie pliku konfiguracyjnego dla dokumentacji danego projektu. Komponenty stowarzyszone: graphviz - oprogramowanie wykorzystywane do towrzenia rysunków grafów. Strona projektu: http://www.research.att.com/sw/tools/graphviz/

Przepływ informacji najważniejsze cechy Ogólna charakterystyka Praca programu doxygen

Plan prezentacji najważniejsze cechy 1 najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 2

najważniejsze cechy Katalogi i rozmieszczenie plików

najważniejsze cechy Katalogi i rozmieszczenie plików Zakładamy, że w katalogu dox uruchamiamy aplikację doxywizard.

najważniejsze cechy Konfiguracja projektu okienko aplikacji doxywizard Ważniejsze ustawienia Katalog roboczy: Katalog ze źródlami: Przeglądanie katalogów:. (bieżący)../prj rekursywne

najważniejsze cechy Konfiguracja trybu pracy Ważniejsze trybu pracy Domyślnie w dokumentacji znajdą się tylko elementy, które są publiczne. (All Entities) W dokumentacji znajdą się również elementy, które nie są zdokumentowane. (Include cross-referenced...) W dokumentacji znajdzie się kod plików nagłówkowych wraz z odsyłaczami do definicji poszczególnych klas.

najważniejsze cechy Konfiguracja formatu generowanej dokumentacji Ważniejsze trybu pracy Domyślnie dokumentacja będzie generowana w podkatalogu html (zostanie on utworzony w trakcie pierwszego uruchomienia programu doxygen). (with frames...) Zostanie utworzone boczny rozwijalny indeks.

najważniejsze cechy Konfiguracja generacji diagramów Ważniejsze trybu pracy Jeśli mamy zainstalowany GraphViz dobrze jest zaznaczyć wszystkie rodzaje diagramów. Pozwoli to mieć pełną informację o strukturze programu i wzajemnych zależności między poszczególnymi metodami i funkcjami.

najważniejsze cechy Generowanie dokumentacji Faza generacji Gdy mamy wszystko ustawione, dobrze jest wcześniej zachować konfigurację do pliku, a następnie uruchomić fazę generacji dokumentacji.

najważniejsze cechy Rezultat uproszczonego zestawu ustawień Cechy wygenerowanej dokumentacji Korzystanie z uproszczonego trybu do zadawania ustawień konfiguracyjnych powoduje, że wygenerowana dokumentacja ma następujące wady: dodatkowe elementy opisu generowane przez doxygen są zawsze tylko w języku angielskim, nazwy plików są podawane z pełną ścieżką dostępu, dokumentacja nie jest generowana dla atrybutów klasy, które znajdują się w sekcji prywatnej. Jeżeli dokumentacja jest robiona dla użytkownika zewnętrznego, to jest to dobre rozwiązanie. Jednak jeśli robimy ją na własne potrzeby i chcemy mieć pełen zestaw informacji, to takie rozwiązanie jest niekorzystne. Aby usunąć te wady należy...

najważniejsze cechy Opcje rozszerzone sekcja Project Ustawienia projektu Należy przejść do zakładki Expert i wykonać następujące operacje: wybrać polską wersję jezykową. korzystnie jest odznaczyć ustawienienie REPEAT BRIEF (dzięki temu nie będzie powtarzany skrócony opis w pełnym opisie danego elementu), należy odznaczyć ustawienie FULL PATH NAMES (nazwy plików będą występowały bez pełnej ścieżki dostępu).

najważniejsze cechy Opcje rozszerzone sekcja Build Ustawienia sposobu generacji dokumentu korzystnie jest zaznaczyć ustawienienie EXTRACT PRIVATE, dzięki temu pojawi się dokumentacja elementów prywatnych klasy. wskazane jest również zaznaczenie ustawienia SHOW DIRECTORIES, pozwoli to mieć informację o strukturze katalogów, w których znajdują się dokumentowane pliki.

najważniejsze cechy Opcje rozszerzone sekcja Build Ustawienia sposobu generacji dokumentu korzystnie jest zaznaczyć ustawienienie EXTRACT PRIVATE, dzięki temu pojawi się dokumentacja elementów prywatnych klasy. wskazane jest również zaznaczenie ustawienia SHOW DIRECTORIES, pozwoli to mieć informację o strukturze katalogów, w których znajdują się dokumentowane pliki.

najważniejsze cechy Opcje rozszerzone sekcja Messages Ustawienia komunikatów warto zaznaczyć ustawienienie QUIET, dzięki temu w trakcie generacji dokumentacji nie pojawiają się komunikaty co jest tworzone (z punktu widzenia poprawności tworzonej dokumentacji zazwyczaj nie są one istotne), wskazane jest również zaznaczenie ustawienia WARN NO PARAMDOC, powoduje to generowanie ostrzeżeń, gdy jakieś parametry metody/funkcji lub wartość, którą zwraca, nie są zdokumentowane.

najważniejsze cechy Opcje rozszerzone sekcja Messages Ustawienia komunikatów warto zaznaczyć ustawienienie QUIET, dzięki temu w trakcie generacji dokumentacji nie pojawiają się komunikaty co jest tworzone (z punktu widzenia poprawności tworzonej dokumentacji zazwyczaj nie są one istotne), wskazane jest również zaznaczenie ustawienia WARN NO PARAMDOC, powoduje to generowanie ostrzeżeń, gdy jakieś parametry metody/funkcji lub wartość, którą zwraca, nie są zdokumentowane.

najważniejsze cechy Opcje rozszerzone sekcja Dot Ustawienia generacji diagramów dobrze jest zaznaczyć ustawienienie CLASS DIAGRAM, dzięki temu pozwoli to na umieszczenie w dokumentacji diagramów klas. Uwaga: nie jest korzystne zaznaczanie ustawienia UML LOOK. Powoduje to powstawanie bardzo szczegółowego diagramu, który staje się nieczytelny.

najważniejsze cechy Opcje rozszerzone sekcja Dot Ustawienia generacji diagramów dobrze jest zaznaczyć ustawienienie CLASS DIAGRAM, dzięki temu pozwoli to na umieszczenie w dokumentacji diagramów klas. Uwaga: nie jest korzystne zaznaczanie ustawienia UML LOOK. Powoduje to powstawanie bardzo szczegółowego diagramu, który staje się nieczytelny.

najważniejsze cechy Generacja dokumentacji - zakładka Run Generacja dokumentacji Jeśli wszystko jest dobrze, to w trakcie generacji dokumentu nie powinno być żadnych ostrzeżeń.

najważniejsze cechy Rezultat uproszczonego zestawu ustawień Cechy wygenerowanej dokumentacji Teraz mamy już opisy po polsku, zaś nazwy plików występują bez pełnej ścieżki dostępu.

Plan prezentacji najważniejsze cechy 1 najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 2

najważniejsze cechy Strona tytułowa zdokumentowanego systemu

Lista plików najważniejsze cechy

najważniejsze cechy Opis pliku kwadrat.hh dla programu doxygen #ifndef KWADRAT_HH #define KWADRAT_HH /*! * \file * \brief Definicja klasy Kwadrat * * Plik zawiera definicję klasy Kwadrat, która * jest klasą pochodną i jest ona specjalizacją * klasy FiguraGeometryczna */ #include "figurageometryczna.hh"... #endif

najważniejsze cechy Opis pliku: kwadrat.hh

najważniejsze cechy Kod pliku (w dokumentacji): kwadrat.hh

najważniejsze cechy Opis pliku kwadrat.hh dla programu doxygen #ifndef KWADRAT_HH #define KWADRAT_HH /*! * \file * \brief Definicja klasy Kwadrat * * Plik zawiera definicję klasy Kwadrat, która * jest klasą pochodną i jest ona specjalizacją * klasy FiguraGeometryczna */ #include "figurageometryczna.hh" /*! * \brief Modeluje pojęcie kwadratu... */ class Kwadrat: public FiguraGeometryczna {... #endif

najważniejsze cechy Dokumentacja klasy Kwadrat

najważniejsze cechy Dokumentacja klasy Kwadrat

najważniejsze cechy Szczegółowy opis klasy Kwadrat i skrócone opisy metod /*! * \brief Modeluje pojęcie kwadratu * * Klasa modeluje pojęcie kwadratu o zadanej długości boku. * Jej atrybutem jest pole zawierające długość boku. * Przyjmuje się, że długość podawana jest w jednostkach * niemianowanych. */ class Kwadrat: public FiguraGeometryczna { public: /*! * \brief Inicjalizuje długość boku * * Inicjalizuje długość boku oraz wymusza wywołania konstruktora * klasy bazowej z identyfikatorem właściwym dla figury geometrycznej * typu kwadrat. * \param[in] DlugoscB - długość boku kwadratu. Jest ona zapisywana * w polu \link Kwadrat:: DlugoscBoku DlugoscBoku\endlink. */ Kwadrat(double DlugoscB): FiguraGeometryczna(TF Kwadrat), DlugoscBoku(DlugoscB) {}...

najważniejsze cechy Dokumentacja metody w klasie Kwadrat

najważniejsze cechy Opis metody w klasie Kwadrat /*! * \brief Modeluje pojęcie kwadratu * * Klasa modeluje pojęcie kwadratu o zadanej długości boku. * Jej atrybutem jest pole zawierające długość boku. * Przyjmuje się, że długość podawana jest w jednostkach * niemianowanych. */ class Kwadrat: public FiguraGeometryczna { public: /*! * \brief Inicjalizuje długość boku * * Inicjalizuje długość boku oraz wymusza wywołania konstruktora * klasy bazowej z identyfikatorem właściwym dla figury geometrycznej * typu kwadrat. * \param[in] DlugoscB - długość boku kwadratu. Jest ona zapisywana * w polu \link Kwadrat:: DlugoscBoku DlugoscBoku\endlink. */ Kwadrat(double DlugoscB): FiguraGeometryczna(TF Kwadrat), DlugoscBoku(DlugoscB) {}...

najważniejsze cechy Dokumentacja metody Kwadrat::ObliczPole()

najważniejsze cechy Opis skrócony metody w klasie Kwadrat w kwadrat.hh /*! * \brief Modeluje pojęcie kwadratu * * Klasa modeluje pojęcie kwadratu o zadanej długości boku. * Jej atrybutem jest pole zawierające długość boku. * Przyjmuje się, że długość podawana jest w jednostkach * niemianowanych. */ class Kwadrat: public FiguraGeometryczna { public:... /*! * \brief Wyznacza pole powierzchni kwadratu */ double ObliczPole() const;...

najważniejsze cechy Opis szczególowy przed definicją metody w kwadrat.cpp #include "kwadrat.hh" /*! * \file * \brief Definicja metody klasy Kwadrat * * Zawiera definicję metod klasy Kwadrat. */ /*! * Wyznacza pole powierzchni danego kwadratu * i zwraca jego wartość. * * \return Zwraca pole powierzchni kwadratu. Jest ono wyrażone * w jednostkach niemianowanych. */ double Kwadrat::ObliczPole() const { return DlugoscBoku* DlugoscBoku; }

najważniejsze cechy Opis szczególowy przed definicją metody w kwadrat.cpp #include "kwadrat.hh" /*! * \file * \brief Definicja metody klasy Kwadrat * * Zawiera definicję metod klasy Kwadrat. */ /*! * Wyznacza pole powierzchni danego kwadratu * i zwraca jego wartość. * * \return Zwraca pole powierzchni kwadratu. Jest ono wyrażone * w jednostkach niemianowanych. */ double Kwadrat::ObliczPole() const { return DlugoscBoku* DlugoscBoku; }

najważniejsze cechy Dokumentacja pliku kwadrat.cpp

najważniejsze cechy Kod pliku kwadrat.cpp w dokumentacji

najważniejsze cechy Dokumentacja pola Kwadrat:: DlugoscBoku

najważniejsze cechy Opis pola Kwadrat:: DlugoscBoku /*! * \brief Modeluje pojęcie kwadratu * * Klasa modeluje pojęcie kwadratu o zadanej długości boku. * Jej atrybutem jest pole zawierające długość boku. * Przyjmuje się, że długość podawana jest w jednostkach * niemianowanych. */ class Kwadrat: public FiguraGeometryczna { public:... private: /*! * \brief Długość boku kwadratu * * Pole zawiera długość boku kwadratu. Przyjmuje * się, że jest ona podana w jednostkach niemianowanych. */ double DlugoscBoku; };

najważniejsze cechy Dokumentacja typu wyliczeniowego

najważniejsze cechy Opis typu wyliczeniowego TypFiguryGeometrycznej /*! * \brief Rodzaj figury geometrycznej modelowanej przez daną klasę * * Wartości tego typu służą jako indentyfikatory dostępnych rodzai * figur geometrycznych. */ enum TypFiguryGeometrycznej { TF Zadna /*! Nie jest to żadna konkretna figura geometryczna */, TF Kwadrat /*! Figura geometryczna jest kawadratem */, TF Kolo /*! Figura geometryczna jest kołem */ };

najważniejsze cechy Wykorzystanie w dokumentacji środowiska verbartim

najważniejsze cechy Opis funkcji. Użycie środowiska verbatim /*! * \brief Wyświetla pole figury geometrycznej * * Funkcja wyświetla pole figury geometrycznej. Na podstawie * identyfikatora typu figury rozpoznaje, czy obiekt jest * częścią składową obiektu klasy Kolo, czy też Kwadrat, * lub czy jest to samodzielny obiekt klasy FiguraGeometryczna. * W zależności od tego wyświetla dokonuje właściwego rzutowania * i wylicza pole figury. Następnie wyświetlany jest komunikat, * w którym jest zawarta nazwa rodzaju figury oraz wartość jej pola, * np. \verbatim Kwadrat Pole = 10 \endverbatim * * \param[in] Figura - figura geometryczna, dla której ma zostać * wyświetlona wartość jej pola. */

Strona główna najważniejsze cechy

najważniejsze cechy Formatowanie strony głównej plik: strona.dox /*! \mainpage 2Ow1L - Bardzo Prosty Przykład Dwóch Rodzai Obiektów w Jednej Liście Aplikacja jest przykładem realizacji dwóch list bez korzystania z mechanizmów metod wirtualnych. Prowadzi to do dość siermiężnej konstrukcji, którą można zobaczyć w kodzie. \section etykieta-wazne-cechy Najważniejsze cechy Lista dwóch rodzai figur ukrywa wewnętrzną strukturę listy. Publiczny interfejs klasy udostępnia metody, które dodają kwadraty lub koła.\n Konstrukcja wspólnej listy bazuje na fakcie, że zarówno obiekty klasy Kwadrat, jak też obiekty klasy Kolo, są... */

najważniejsze cechy Formatowanie strony głównej plik: strona.dox /*! \mainpage 2Ow1L - Bardzo Prosty Przykład Dwóch Rodzai Obiektów w Jednej Liście Aplikacja jest przykładem realizacji dwóch list bez korzystania z mechanizmów metod wirtualnych. Prowadzi to do dość siermiężnej konstrukcji, którą można zobaczyć w kodzie. \section etykieta-wazne-cechy Najważniejsze cechy Lista dwóch rodzai figur ukrywa wewnętrzną strukturę listy. Publiczny interfejs klasy udostępnia metody, które dodają kwadraty lub koła.\n Konstrukcja wspólnej listy bazuje na fakcie, że zarówno obiekty klasy Kwadrat, jak też obiekty klasy Kolo, są... */

najważniejsze cechy Strona główna wariant z danymi autora

najważniejsze cechy Strona główna wariant z danymi autora plik: strona.dox /*! \mainpage 2Ow1L - Bardzo Prosty Przykład Dwóch Rodzai Obiektów w Jednej Liście \author Jan Kowalski \date 06.05.1012 \version 0.1 Aplikacja jest przykładem realizacji dwóch list bez korzystania z mechanizmów metod wirtualnych. Prowadzi to do dość siermiężnej konstrukcji, którą można zobaczyć w kodzie. \section etykieta-wazne-cechy Najważniejsze cechy Lista dwóch rodzai figur ukrywa wewnętrzną strukturę listy. Publiczny interfejs klasy udostępnia metody, które... */

najważniejsze cechy Wybrane sposoby zmiany stylu czcionki łamanie linii /*!... To jest przykład\n wymuszenia łamania linii. Odpowiada za to znak \\n. */

najważniejsze cechy Wybrane sposoby zmiany stylu czcionki pismo pochyłe /*!... To jest przykład wymuszenia \e pisma \e pochyłego. Odpowiada za to polecenie \\e. */

najważniejsze cechy Wybrane zmiany stylu czcionki pismo maszynowe /*!... To jest przykład \p pisma \p maszynowego. Odpowiada za to polecenie \\p. */

Plan prezentacji najważniejsze cechy 1 najważniejsze cechy Ogólna charakterystyka Praca programu doxygen 2

Linia polecenia najważniejsze cechy Dokumentację można wygenerować wywołując z linii polecenia program doxygen. W wywołaniu tym jako parametru należy użyć pliku (wraz ze ścieżką dostępu, o ile plik ten nie znajduje się w bieżącej kartotce), który zawiera konfigurację dla danej dokumentacji. Konsola: jkowalsk@panamint> doxygen Doxyfile

Linia polecenia najważniejsze cechy Lepszym jednak pomysłem jest stworzenie odpowiedniego pliku Makefile. Pozwala to przekierować wyjście standard error do pliku. Dzięki temu późnej można przeglądać wszystkie ostrzeżenia i komunikaty bez komunikatów informacyjnych generowanych przez program doxygen. Konsola: jkowalsk@panamint> make

najważniejsze cechy Przykładowa minimalna zawartość pliku Makefile Makefile start doxy : doxygen Doxyfile 2> doxy.log less doxy.log

najważniejsze cechy Koniec prezentacji Dziękuję za uwagę