Błąd #5474

Generowanie doxygena nie powinno być domyślne

Added by Adam Radziszewski about 9 years ago. Updated about 9 years ago.

Status:ZamkniętyStart date:04 Jun 2014
Priority:NormalnyDue date:
Assignee:Adam Radziszewski% Done:

100%

Category:-
Target version:c++

Description

Nie każdy w systemie ma doxygen, a dokumentacja techniczna generowana z poziomu kodu potrzebna jest programistom, a zwykłym użytkownikom nie.
Dlatego opcją domyślną w CMake powinno być niegenerowanie dokumentacji.
Ważne jest też, by CMake się nie wywalał, gdy nie ma w systemie doxygena.

Jest jeszcze dodatkowy problem:

Error removing directory "/home/eliasz/proj/wcrft/doc/html

Stało się to, gdy usunąłem bin i uruchomiłem na nowo (katalogu doc/html rzeczywiście nie było).

History

#1 Updated by Radosław Warzocha about 9 years ago

  • Status changed from Nowy to Rozwiązany
  • Assignee changed from Radosław Warzocha to Adam Radziszewski
  • % Done changed from 0 to 100

Wyłączyłem domyślne generowanie dokumentacji i poprawiłem kilka warningów.

Jeśli chodzi o błąd z usuwaniem katalogów, to nie występuje on, gdy zamiast
$ make
$ sudo make install
wpiszemy po prostu
sudo make install

Nie wydaje mi się, żeby udało się to inaczej obejść. sudo make install próbuje zbudować wszystkie target@y ponownie, a @custom_target (documentation) zawsze jest oznaczony jako nieaktualny.

#2 Updated by Adam Radziszewski about 9 years ago

  • Status changed from Rozwiązany to Przypisany

Jeśli chodzi o błąd z usuwaniem katalogów, to nie występuje on, gdy zamiast
$ make
$ sudo make install
wpiszemy po prostu
sudo make install

Nie wydaje mi się, żeby udało się to inaczej obejść. sudo make install próbuje zbudować wszystkie target@y ponownie, a @custom_target (documentation) zawsze jest oznaczony jako nieaktualny.

To nie jest rozwiązanie. Złą praktyką jest mejkowanie z sudo. W szczególności ktoś może nie chcieć w ogóle tego instalować w katalogu systemowym. Może nie mieć w ogóle uprawnień administratora.

Spróbuję coś z tym zrobić.

#3 Updated by Adam Radziszewski about 9 years ago

  • Status changed from Przypisany to Zamknięty

Usunąłem usuwanie katalogów, chyba to nie jest niezbędne.

Also available in: Atom PDF