בכל אופן, מצאתי משהו כזה בספר Java How to Program: לדוגמא

// Fig. 7.6: BarChart.java
2 // Bar chart printing program.
34
public class BarChart
5 {
6 public static void main( String args )
7 {
8 int array = { 0, 0, 0, 0, 0, 0, 1, 2, 4, 2, 1 };
9
10 System.out.println( "Grade distribution:" );
11
12 // for each array element, output a bar of the chart
13 for ( int counter = 0; counter < array.length; counter++ )
14 {
15 // output bar label ( "00-09: ", ..., "90-99: ", "100: " )
16 if ( counter == 10 )
17 System.out.printf( "%5d: ", 100 );
18 else
19 System.out.printf( "%02d-%02d: ",
20 counter * 10, counter * 10 + 9 );
21
22
23
24
25
26 System.out.println(); // start a new line of output
27 } // end outer for
28 } // end main
29 } // end class BarChart

למרות שזה לא הצליח להעתיק את כל הקוד, אפשר לראות מה הכוונה. נראה שזה ממשיך ככה גם בפרקים המתקדמים יותר של הספר...

אני חושב שזאת בקשה לגיטימית, במיוחד לפרוייקט שמישהו עשה ללימודים, שהוא צריך להוכיח שהוא באמת מבין מה הקוד עושה.

איך זה שאתה מוסיף תיעוד מוכיח שאתה מבין מה הקוד עושה?

אתה באמת צריך הסבר על כל שורה ושורה? אתה מבין רק משם הפונקציה מה היא עושה.

או השורה הזאת:

extension = extension.toLowerCase(Locale.US);

getting the extension to lower case
extension = extension.toLowerCase(Locale.US);