/doc (Elabora i commenti per la documentazione) (C/C++)
Aggiornamento: novembre 2007
Indica al compilatore di elaborare i commenti relativi alla documentazione nei file di codice sorgente e di creare un file xdc per ciascun file di codice sorgente che contiene commenti relativi alla documentazione.
/doc[name]
Argomenti
- name
Nome del file xdc che verrà creato dal compilatore. È valido solo quando nella compilazione viene passato un file cpp.
Note
I file xdc vengono elaborati in un file xml con xdcmake.exe. Per ulteriori informazioni, vedere XDCMake Reference.
È possibile aggiungere commenti relativi alla documentazione nei propri file di codice sorgente. Per ulteriori informazioni, vedere Recommended Tags for Documentation Comments (Visual C++).
/doc non è compatibile con /clr:oldSyntax. Per ulteriori informazioni, vedere /clr (Compilazione Common Language Runtime).
Per utilizzare il file xml generato con IntelliSense, il nome del file xml deve essere uguale al nome dell'assembly che si desidera supportare e la directory del file xml deve essere la stessa dell'assembly. Quando nel progetto Visual Studio viene fatto riferimento all'assembly, verrà trovato anche il file xml. Per ulteriori informazioni, vedere Utilizzo di IntelliSense e Inserimento di commenti al codice XML.
Per impostare l'opzione del compilatore nell'ambiente di sviluppo di Visual Studio
Aprire la finestra di dialogo Pagine delle proprietà del progetto. Per informazioni dettagliate, vedere Procedura: aprire le pagine delle proprietà dei progetti.
Espandere il nodo Proprietà di configurazione.
Espandere il nodo C/C++.
Selezionare la pagina delle proprietà File di output.
Modificare la proprietà Genera file di documentazione XML.
Per impostare l'opzione del linker a livello di codice
- Vedere la proprietà GenerateXMLDocumentationFiles.