/doc (Przetwarzaj komentarze dokumentacji) (C/C++)
Powoduje, że kompilator do komentarzy dokumentacji procesu w pliki kodu źródłowego oraz tworzenia pliku .xdc dla każdego pliku kodu źródłowego ma komentarzy dokumentacji.
/doc[name]
Argumenty
- name
Nazwa pliku .xdc, który zostanie utworzony kompilator.Tylko wtedy, gdy jeden plik CPP jest przekazywana w kompilacji.
Uwagi
Pliki .xdc są przetwarzane do postaci pliku XML z xdcmake.exe.Aby uzyskać dodatkowe informacje, zobacz XDCMake — odwołanie.
Można dodawać komentarze dokumentacji do plików kodu źródłowego.Aby uzyskać dodatkowe informacje, zobacz Znaczniki zalecane dla komentarzy do dokumentacji (Visual C++).
Opcja /doc nie jest zgodna z poleceniem /clr:oldSyntax. Aby uzyskać więcej informacji, zobacz /clr (Kompilacja środowiska uruchomieniowego języka wspólnego).
Aby użyć pliku XML wygenerowany za pomocą technologii IntelliSense, należy nazwę pliku pliku .xml, jest taka sama, jak zestaw, który chcesz obsługiwać i umieścić plik XML w tym samym katalogu co zestaw.W przypadku zestawu odwołuje się do projektu programu Visual Studio, również znajduje się plik XML.Aby uzyskać więcej informacji, zobacz Korzystanie z IntelliSense i Stosowanie komentarzy kodu XML.
Aby ustawić tę opcję kompilatora w środowisku programowania Visual Studio
Otwórz okno dialogowe Strony właściwości projektu.Szczegółowe informacje – zobacz: Porady: otwieranie stron właściwości projektów.
Rozwiń węzeł Właściwości konfiguracji.
Rozwiń węzeł C/C++.
Wybierz Pliki wyjściowe strona właściwości.
Modyfikowanie Generowanie plików dokumentacji XML właściwości.
Aby programowo ustawić opcję konsolidatora
- Zobacz GenerateXMLDocumentationFiles.