Przykład

void doEverything(int argc, char* argv[])
{
/*
*
* Komentarze również składają się na fizyczną długość funkcji.
*
*
* W przypadku zliczania instrukcji ta metoda da wynik 13.
*
* */

if(argc>1){
cout << "Odczytywanie wszystkich plików";
for(int i=1; i<argc; i++){
cout << "odczytywanie pliku " << argv[i] << endl;
char temp[1000];
fstream file(argv[i], ios::in);
cout << "treść pliku to: " << endl;
while(!file.eof()){
file.getline(temp, 1000);
cout << temp;
}
file.close();
}
}
else{
cout << "Nie określono plików";
}
}

Rozwiązanie

Twórz mniejsze i bardziej konkretne funkcje. Nagłówki i komentarze wstawiane powinny być wystarczające na potrzeby dokumentacji.

void readOneFile(char* fileName);

/*
*
* Nagłówek funkcji readEachFile(int argc, char* argv[])
* Odczytuje podaną listę plików.
*
* */
void readEachFile(int argc, char* argv[])
{
if(argc>1){//pierwszy parametr to plik wykonywalny
cout << "Odczytywanie wszystkich plików";
for(int i=1; i<argc; i++){
cout << "odczytywanie pliku " << argv[i] << endl;
readOneFile(argv[i]);
}
}
else{
cout << "Nie określono plików";
}
}

void readOneFile(char* fileName){
char temp[1000];
fstream file(fileName, ios::in);
cout << "treść pliku to: " << endl;
while(!file.eof()){
file.getline(temp, 1000);
cout << temp;
}
file.close();
}