Les standards de codage pour le C/C++ ou d'autres langages sont utilis�s dans le but de rendre les programmes plus lisibles/compr�hensibles par les programmeurs. Pour cela, il existe des embellisseurs C/C++ (outils de formatage). Le code format� (embelli) augmente la productivit� des programmeurs de 100%!!
Sur GNU/Linux/Unix, il existe des commandes appel�es "indent" et "cb". R�f�rez-vous aux pages de manuel par 'man indent' et 'man cb'. Notez que indent et cb fonctionnent uniquement pour les programmes "C". Pour les programmes "C++", utilisez "bcpp". T�l�chargez ce programme de mise en forme � partir des sites suivants :
BCPP a �t� �crit par Steven De Toni
Pour �tre sur � 100%, vous devez utiliser une approche SCIENTIFIQUE pour valider et avoir confiance en un programme de mise en forme. La m�thode d�crite dans cette section permettra au programme de mise en forme d'�tre agr�� comme �tant "vraiment fiable" et s�rieux. Dans le but de v�rifier qu'un programme de mise en forme comme bcpp, indent ou cb ne provoque pas de dommage ou ne change pas le code source d'entr�e apr�s formatage, vous pouvez utiliser le script shell Programme de v�rification ou utiliser la technique suivante :
G�n�rez le code objet � partir du code source original en utilisant le compilateur :
g++ -c monprogramme.cpp
Sauvez ce fichier :
mv monprogramme.o monprogramme_orig.o
Maintenant, lancez bcpp :
bcpp monprogramme.cpp
g++ -c monprogramme.cpp
diff monprogramme.o monprogramme_orig.o
g++ -S monprogramme.cpp
diff monprogramme.s monprogramme_orig.s
Il est fortement recommand� de faire ces deux �tapes chaque fois que vous lancerez un programme de mise en forme comme bcpp, indent ou cb.
Visitez les sites suivants pour obtenir des embellisseurs pour d'autres langages comme HTML, SQL, Java, Perl, Fortran.
Pour pr�senter du code sous format HTML :
Ceci est un script pour le shell Korn pour v�rifier les programmes de mise en forme. Il a besoin de "pdksh*.rpm" � partir du cdrom 'contrib' de Linux. Sauvez ce fichier en tant que fichier 'texte' et appliquez sur ce fichier la commande chmod a+rx. Vous pouvez r��crire ce script shell en Perl pour pouvoir l'utiliser sous Windows 95/NT ou MSDOS. Enlevez les commentaires de la variable PRGM pour le faire pointer sur bcpp, cb ou indent.
#!/bin/ksh
# Programme de v�rification pour contr�ler des embellisseurs C++ comme 'bcpp', 'indent' ou 'cb'
############################################################
# Copyright
# Les droits d'auteurs sont sous les termes de la GNU/GPL.
# Auteur: Al Dev (Alavoor Vasudevan) [email protected]
# Traducteur : Robert Jacolin [email protected]
############################################################
check_beautify_now()
{
# Efface tous les fichiers temporaires ...
\rm -f ${TMP_FILE}
\rm -f ${TMP_CPPFILE}*.*
FNAME=$1
if [ ! -f ${FNAME} ]; then
print "\nErreur : Le fichier ${FNAME} n'existe pas!!. Arr�t imm�diat ...."
exit
fi
\cp -f ${FNAME} ${TMP_CPPFILE}.cpp
${COMPILER} -c ${TMP_CPPFILE}.cpp
if [ ! -f ${TMP_CPPFILE}.o ]; then
print "Erreur Fatale : Impossible de compiler ${FNAME}. Arr�t imm�diat ... "
exit
fi
\mv -f ${TMP_CPPFILE}.o ${TMP_CPPFILE}_orig.o
aa=`basename $PRGM`
print "\nEn cours, v�rification de $aa sur ${FNAME}"
${PRGM} ${TMP_CPPFILE}.cpp
${COMPILER} -c ${TMP_CPPFILE}.cpp
\rm -f $TMP_FILE
diff ${TMP_CPPFILE}.o ${TMP_CPPFILE}_orig.o 1> $TMP_FILE 2>> $TMP_FILE
result=""
result=`wc -c $TMP_FILE | awk '{print $1}' `
if [ "$result" = "0" ]; then
print "Succ�s!! La mise en forme de $aa fonctionne proprement!!\n"
else
print "Erreur Fatale : Quelque chose ne va pas!! La mise en forme ne fonctionne pas!!"
exit
fi
# ${COMPILER} -S ${TMP_CPPFILE}.cpp
# diff ${TMP_CPPFILE}.s ${TMP_CPPFILE}_orig.s
# Efface tous les fichiers temporaires ....
\rm -f ${TMP_FILE}
\rm -f ${TMP_CPPFILE}*.*
}
########## La partie principale du programme commence ici ##################
#PRGM=/usr/bin/bcpp
#PRGM=/usr/bin/cb
PRGM=/usr/bin/indent
COMPILER=/usr/bin/g++
TMP_FILE=beautify.tmp
TMP_CPPFILE=beautify-tmp_cppfile
print -n "Entrez le nom du fichier C++ <valeur par d�faut *.cpp> : "
read ans
if [ "$ans" = "" -o "$ans" = " " ]; then
ans="ALL"
else
FILENAME=$ans
fi
# Efface tous les fichiers temporaires ....
\rm -f ${TMP_FILE}
\rm -f ${TMP_CPPFILE}*.*
if [ "$ans" != "ALL" ]; then
check_beautify_now ${FILENAME}
else
ls *.cpp |
while read FILENAME
do
check_beautify_now ${FILENAME}
done
fi
Visitez les sites suivants en rapport avec le C, C++ :
Ce document est publi� dans 11 formats diff�rents qui ont pour noms : DVI, Postscript, Latex, Adobe Acrobat PDF, LyX, GNU-info, HTML, RTF (Rich Text Format : Format de texte enrichi), texte simple, pages de manuel Unix et SGML.
bash$ man sgml2latex bash$ sgml2latex filename.sgml bash$ man dvips bash$ dvips -o filename.ps filename.dvi bash$ distill filename.ps bash$ man ghostscript bash$ man ps2pdf bash$ ps2pdf input.ps output.pdf bash$ acroread output.pdf &
Ce document (version anglaise) est situ� � :
Vous pouvez aussi trouver ce document sur les sites miroirs suivant :
Pour visualiser un document au format DVI, utilisez le programme xdvi. Le programme xdvi est situ� dans le paquetage tetex-xdvi*.rpm dans la Linux Redhat. Il peut �tre trouv� par l'interm�diaire des boutons de menu Panneau de Contr�le (ControlPannel) | Applications (Applications) | Publications (Publishing) | TeX (TeX).
Pour lire un document dvi, utilisez la commande :
xdvi -geometry 80x90 howto.dvi
man xdvi
Vous pouvez lire un fichier Postscript gr�ce au programme 'gv' (ghostview) ou 'ghostscript'. Le programme ghostscript est dans le paquetage ghostscript*.rpm et le programme gv est dans le paquetage gv*.rpm dans la distribution linux Redhat qui peut se trouver en utilisant les boutons du menu Panneau de Contr�le (Control panel) | Applications (Applications) | graphiques (Graphics). Le programme gv est beaucoup plus facile � utiliser que ghostscript. Ghostscript et gv existent aussi sous d'autres plate-formes comme OS/2, Windows 95 et NT.
gv howto.ps
ghostscript howto.ps
Vous pouvez lire les documents latex ou Lyx g�n�r�s en utilisant Lyx qui est une interface graphique sous "X-Window" pour latex.
La licence du copyright est la licence GNU/GPL comme pour le LDP (Linux Documentation Project, le projet de documentation de Linux). Le LDP est un projet sous licence GNU/GPL. Les restrictions additionnelles sont : vous devez laisser le nom de l'auteur, l'adresse email et cette note sur le droit d'auteurs sur toutes les copies. Si vous faites un quelconque changement ou addition dans ce document, vous devez alors pr�venir tous les auteurs de ce document.