Torna indietro   Hardware Upgrade Forum > Software > Programmazione > Corsi, Tutorial e FAQ

Sony Xperia 5 II, ecco il migliore smartphone Sony del 2020. La recensione
Sony Xperia 5 II, ecco il migliore smartphone Sony del 2020. La recensione
Se Sony Xperia 1 II erano uno smartphone rivolto a utenti molto esigenti in fatto di "creatività", Xperia 5 II è meno estremo e punta a un pubblico più vasto. Rispetto al modello più costoso ha anche qualche feature aggiuntiva e l'assenza del supporto al 4K non si fa sentire più di tanto. Rimangono affidabilità e prestazioni, il tutto impreziosito dai 120Hz che mancavano su Xperia 1 II. Ecco la nostra recensione.
Samsung Galaxy Book S: il notebook compatto con CPU Intel Lakefield
Samsung Galaxy Book S: il notebook compatto con CPU Intel Lakefield
Dimensioni molto compatte, raffreddamento completamente passivo e silenzioso e bel design: queste le caratteristiche tecniche di Samsung Galaxy Book S, notebook che si contraddistingue dai concorrenti per l'utilizzo di un processore Intel Core della famiglia Lakefield con architettura ibrida. Il consumo contenuto non permette però di far registrare prestazioni allineate alla media dei notebook sottili.
Recensione KFA2 GeForce RTX 3070 SG (1-Click OC), c'è una quarta ventola opzionale
Recensione KFA2 GeForce RTX 3070 SG (1-Click OC), c'è una quarta ventola opzionale
Abbiamo provato la nuova KFA2 GeForce RTX 3070 SG (1-Click OC), una scheda video che si presenta con un sistema di raffreddamento a tripla ventola che può essere "potenziato" con un quarta ventola aggiuntiva da posizionare nella parte posteriore. Sarà davvero efficace? Scopriamolo nella nostra recensione.
Tutti gli articoli Tutte le news

Vai al Forum
Rispondi
 
Strumenti
Old 24-12-2003, 11:10   #1
Luc@s
Senior Member
 
L'Avatar di Luc@s
 
Iscritto dal: Apr 2002
Città: Vigevano(PV)
Messaggi: 2123
[Tutorial] Doxygen

Doxygen Tutorial
Doxygen è un software open source utilissimo(1) che permette di documentare un software scritto in Java/C/C++.
Si compone di 2 files doxygen.exe e doxytag.exe che possono essere messi ove si vuole ma per chiamarli
senza dover inserire sempre il percorso bisogna inserirli nel PATH.
Per spiegare il funzionamento di questo tool prendiamo un codice di esempio:

Codice:
#include <iostream>

/// il namespace std
using namespace std;

/// Classe Generica
class Prova
{
	public:
		///Costruttore
		Prova(){ };
		///Distruttore
		~Prova(){ };
		/// Funz che saluta
		inline char * saluta(char * nm){ return nm; };
	private:
};

int main()
{
	return 0;
}
Doxygen accetta come parametro(obligatorio) il file di configurazione, che può essere chiamato a proprio
piacimento.
Quote:
doxygen <config-file>
Noi per comodità lo chiameremo doxy.conf.
Il files sarà cosi composto:

Quote:
; Il nome del progetto
PROJECT_NAME = "Prova"
;La lingua
OUTPUT_LANGUAGE = "Italian"
; La directory ove porre la documentazione
OUTPUT_DIRECTORY = "doc"
; # I Seguenti valori accettano YES o NO #
; Genera la documentazione HTML
GENERATE_HTML = YES
; Permette la navigazione tra i files
SOURCE_BROWSER = YES
; Disabilità la creazione della documentazione in formato LATEX
GENERATE_LATEX = NO
; Legge le sotto-directory ricorsivamente
RECURSIVE = YES
; Permette l' espansione delle macro
MACRO_EXPANSION = YES
Salviamo il files di configurazione nella directory principale del programma
Il risultato dell' operazione e visibile nel mio sito(2).
Dopo questa introduzione possiamo passare ad opzioni più avanzate.
Aggiungeremo ora al nostro doxy.conf le seguenti opzioni e proveremo a vedere il risultato:

Quote:
; # I Seguenti valori accettano YES o NO #
; Opzione disponibile per soli programmi in C
OPTIMIZE_OUTPUT_FOR_C = NO
; Opzione disponibile per soli programmi in Java
OPTIMIZE_OUTPUT_JAVA = NO
; Mostra il tag [inline] difianco ai membri di classe che lo sono
INLINE_INFO = YES
; Valuta le espressioni macro presenti nel progetto
ENABLE_PREPROCESSING = YES
; Se attivo Doxygen mostra le relazioni tra i template e le sue istanze
TEMPLATE_RELATIONS = YES
; Permette la ricerca ma sul server deve essere presente PHP versione 4.1.0 o successive
SEARCHENGINE = NO
Detto questo ora possiamo dire che d'ora in poi i nostri programmi e librerie potranno essere
documentati senza problemi



Luc@s

(1) http://www.stack.nl/~dimitri/doxygen...html#latestsrc
(2) allegato
Allegati
File Type: rar doc.rar (9.7 KB, 104 visite)
__________________
Gnu/Linux User
Luc@s è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 10:08   #2
Luc@s
Senior Member
 
L'Avatar di Luc@s
 
Iscritto dal: Apr 2002
Città: Vigevano(PV)
Messaggi: 2123
Piccolo consiglio, lasciate la lingua di default perche la traduzione di ora nn mi sembra il maximo.


Ciao e aspetto feedback
__________________
Gnu/Linux User
Luc@s è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 11:29   #3
VICIUS
Senior Member
 
L'Avatar di VICIUS
 
Iscritto dal: Oct 2001
Messaggi: 11471
Non ho esperienza con doxy ma con javadoc ogni tanto ci lavoravo. Mi chiedevo se anche in doxy fosse possibile usare qui tag come @autor, @version, @param, @return...

tutti i commenti /// vengono messi nel file HTML vero ? perchè nel tutorial non se ne parla.

ciao
VICIUS è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 11:32   #4
Luc@s
Senior Member
 
L'Avatar di Luc@s
 
Iscritto dal: Apr 2002
Città: Vigevano(PV)
Messaggi: 2123
Quote:
Originariamente inviato da VICIUS
Non ho esperienza con doxy ma con javadoc ogni tanto ci lavoravo. Mi chiedevo se anche in doxy fosse possibile usare qui tag come @autor, @version, @param, @return...

tutti i commenti /// vengono messi nel file HTML vero ? perchè nel tutorial non se ne parla.

ciao
Con l' opt OPTIMIZE_OUTPUT_JAVA = YES si puo
Cmq per l' html si puo usare /// per il C++/Java
/** */ x il C.

Ti è sembrato completo com tutorial?
__________________
Gnu/Linux User
Luc@s è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 11:36   #5
VICIUS
Senior Member
 
L'Avatar di VICIUS
 
Iscritto dal: Oct 2001
Messaggi: 11471
A parte i dubbi che che mi erano venuti prima . si l'ho trovato un buon tutorial per un niubbo visto che sono riuscito a fare qualcosa pure io

ciao
VICIUS è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 11:45   #6
Luc@s
Senior Member
 
L'Avatar di Luc@s
 
Iscritto dal: Apr 2002
Città: Vigevano(PV)
Messaggi: 2123
Quote:
Originariamente inviato da VICIUS
A parte i dubbi che che mi erano venuti prima . si l'ho trovato un buon tutorial per un niubbo visto che sono riuscito a fare qualcosa pure io

ciao
Cosa è uscito???
Posso vedere?
__________________
Gnu/Linux User
Luc@s è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 12:23   #7
VICIUS
Senior Member
 
L'Avatar di VICIUS
 
Iscritto dal: Oct 2001
Messaggi: 11471
una classe appena accennata. http://pigaz.altervista.org/doxy-test.tar.bz2

ciao
VICIUS è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 12:27   #8
Luc@s
Senior Member
 
L'Avatar di Luc@s
 
Iscritto dal: Apr 2002
Città: Vigevano(PV)
Messaggi: 2123
cmq la trad italiana nn è il massimo, vero?
__________________
Gnu/Linux User
Luc@s è offline   Rispondi citando il messaggio o parte di esso
Old 27-12-2003, 12:43   #9
VICIUS
Senior Member
 
L'Avatar di VICIUS
 
Iscritto dal: Oct 2001
Messaggi: 11471
Quote:
Originariamente inviato da Luc@s
cmq la trad italiana nn è il massimo, vero?
a parte le ripetizioni, e alcuni doppi sensi sui membri...

ciao
VICIUS è offline   Rispondi citando il messaggio o parte di esso
Old 28-12-2003, 18:53   #10
Luc@s
Senior Member
 
L'Avatar di Luc@s
 
Iscritto dal: Apr 2002
Città: Vigevano(PV)
Messaggi: 2123
me lo puoi testare per il java????


Tnk
__________________
Gnu/Linux User
Luc@s è offline   Rispondi citando il messaggio o parte di esso
Old 28-12-2003, 19:20   #11
VICIUS
Senior Member
 
L'Avatar di VICIUS
 
Iscritto dal: Oct 2001
Messaggi: 11471
certo qui c'è l'output di un piccolo esercizio fatto in java che feci qualche tempo fa. http://pigaz.altervista.org/doxy-java.tar.bz2. è piuveloce di javadoc e la documentazione tiene di meno pero il riusultato è un po "incasinato" e non è completo. secondo me si puo ancora migliorare.

ciao
VICIUS è offline   Rispondi citando il messaggio o parte di esso
Old 28-12-2003, 19:40   #12
Luc@s
Senior Member
 
L'Avatar di Luc@s
 
Iscritto dal: Apr 2002
Città: Vigevano(PV)
Messaggi: 2123
meglio di fare tutto a mano.
Cmq e opensource quindi sempre aggiornato
__________________
Gnu/Linux User
Luc@s è offline   Rispondi citando il messaggio o parte di esso
Old 20-07-2005, 12:21   #13
gotam
Senior Member
 
L'Avatar di gotam
 
Iscritto dal: Aug 2000
Città: Formia
Messaggi: 6668
Azzzz ottimo doxygen
__________________
"La birra è la prova che dio ci ama e vuole che siamo felici"
gotam è offline   Rispondi citando il messaggio o parte di esso
Old 19-05-2006, 09:42   #14
Sirbako
Senior Member
 
L'Avatar di Sirbako
 
Iscritto dal: Oct 2004
Città: Rovereto (tn)
Messaggi: 2184
un conisglio per il tutorial:
dovresti aggiungere una breve spiegazione su come inserirei i commenti, se c sono caratteri speciali per avere autore ecc..
ciao
__________________

Esse.Ti.?!?
Sirbako è offline   Rispondi citando il messaggio o parte di esso
Old 15-06-2009, 13:53   #15
cgiocoli
Junior Member
 
L'Avatar di cgiocoli
 
Iscritto dal: Feb 2006
Città: Padova
Messaggi: 13
info-caratteri e colori

Ciao ragazzi,
è un po' che sto bazzicando con il C++ e la creazione della documentazione
con doxygen. Sapete come si possono implementare i caratteri e i colori, per sembio bold e rosso?

grazie mille
__________________
---
The time is gone the song is over, thought I'd something more to say!
cgiocoli
cgiocoli è offline   Rispondi citando il messaggio o parte di esso
Old 16-12-2011, 15:54   #16
Old Siam Sir
Member
 
Iscritto dal: Oct 2007
Messaggi: 38
Ciao a tutti, sto provando a usare doxygen, ho scaricato l'ultima versione, con Doxywizard che funge da interfaccia grafica e vorrei usarlo per creare della documentazione dai commenti che ho inserito nel codice... solo che non riesco a capire come devono essrere formattati i commenti visto che il VHDL non usa "/*", "//*" o "///" ma definisce i commenti come frasi precedute da "--".
Qualcuno è in grado di aiutarmi?
Grazie mille anticipatamente a tutti!
Old Siam Sir è offline   Rispondi citando il messaggio o parte di esso
Old 03-04-2012, 12:36   #17
Blackskull182
Member
 
L'Avatar di Blackskull182
 
Iscritto dal: Mar 2007
Messaggi: 205
Grazie!
__________________
Tutti gli imbecilli della Borghesia che pronunciano continuamente le parole: immorale, immoralità, moralità nell’arte e altre bestialità mi fanno pensare a Louise Villedieu, puttana da cinque franchi, che accompagnandomi una volta al Louvre, dove non era mai stata, si mise ad arrossire, a coprirsi la faccia, e tirandomi a ogni momento per la manica, mi domandava davanti alle statue e ai quadri immortali come si potesse esporre pubblicamente simili indecenze. (Charles Baudelaire)
Blackskull182 è offline   Rispondi citando il messaggio o parte di esso
 Rispondi


Sony Xperia 5 II, ecco il migliore smartphone Sony del 2020. La recensione Sony Xperia 5 II, ecco il migliore smartphone So...
Samsung Galaxy Book S: il notebook compatto con CPU Intel Lakefield Samsung Galaxy Book S: il notebook compatto con ...
Recensione KFA2 GeForce RTX 3070 SG (1-Click OC), c'è una quarta ventola opzionale Recensione KFA2 GeForce RTX 3070 SG (1-Click OC)...
Recensione MSI RTX 3090 SUPRIM X 24G, una fusione di eleganza e potenza Recensione MSI RTX 3090 SUPRIM X 24G, una fusion...
HUAWEI Mate 40 Pro: potenzialità incredibili come pochi altri. La recensione HUAWEI Mate 40 Pro: potenzialità incredib...
Il Black Friday di Microsoft è qu...
Elon Musk supera Bill Gates e diventa il...
Cyberpunk 2077: ecco quante ore serviran...
Sony: PlayStation 5 esaurita? Inevitabil...
BOE mostra il primo TV 4K da 55 pollici ...
Porsche Taycan, nuovo record per un'auto...
iPad Pro in arrivo con display OLED, ma ...
POCO M3 è ufficiale: incredibile ...
Sony promette di supportare il VRR su PS...
API Vulkan, le estensioni ufficiali per ...
Spotify, oltre 300 mila account del serv...
Amazon speciale videogiochi: i migliori ...
Super Mario Bros. 3 battuto all'asta a 1...
Apple boccia i pannelli AMOLED della cin...
Tesla contro Lucid Air: più auton...
OCCT
HWMonitor
K-Lite Codec Pack Update
K-Lite Mega Codec Pack
K-Lite Codec Pack Full
K-Lite Codec Pack Standard
K-Lite Codec Pack Basic
Process Lasso
Opera Portable
Opera 72
Dropbox
Mozilla Thunderbird 78
Google Chrome Portable
Chromium
iTunes 12
Tutti gli articoli Tutte le news Tutti i download

Strumenti

Regole
Non Puoi aprire nuove discussioni
Non Puoi rispondere ai messaggi
Non Puoi allegare file
Non Puoi modificare i tuoi messaggi

Il codice vB è On
Le Faccine sono On
Il codice [IMG] è On
Il codice HTML è Off
Vai al Forum


Tutti gli orari sono GMT +1. Ora sono le: 20:01.


Powered by vBulletin® Version 3.6.4
Copyright ©2000 - 2020, Jelsoft Enterprises Ltd.
Served by www1v