0.0.0.2.2 - Olá Mundo com comentários e Javadoc

001/* O comentário iniciado por barra asterisco e terminado por asterisco barra
002   pode ocupar várias linhas que serão ignoradas tanto pelo compilador (javac)
003   quanto pelo documentador (javadoc). O comentário iniciado por barra 
004   asterisco asterisco e terminado por asterisco barra é lido pelo documentador
005   que gera arquivos html que documentam o programa escrito com o conteúdo do 
006   comentário. O bloco documentado vai sempre depois do comentário. 
007   javadoc -d html -linksource -notree -noindex -nohelp -nonavbar -charset UTF-8 Ola.java
008   */
009/** Tornou-se padrão no ensino de linguagens de programação que o primeiro 
010    programa apresentado seja um que simplesmente escreve Olá Mundo.
011    Nas linguagens de programação que conheço, este é um dos programas mais 
012        simples. Cito duas utilidades para ele: 
013<ol>
014<li> Primeira apresentação da linguagem de programação; </li>
015<li> Checar se o ambiente de desenvolvimento está funcionando. </li>
016</ol>
017<p>
018    No Windows a forma mais fácil de instalar o ambiente de desenvolvimento é 
019        através do site da Oracle. Há vários tipos de Java: SE, EE, ME, ... o tipo
020        que será usado na disciplina é Java SE. O ambiente de desenvolvimento Java 
021        é chamado Java Development Kit (JDK) e pode ser "baixado" de 
022        http://www.oracle.com/technetwork/java/javase/overview/index.html.
023</p>
024<p> JDK é o conjunto de ferramentas para desenvolver e documentar programas em
025    Java. Destarte, as ferramentas que usaremos são: java, javac e javadoc.
026        Após baixar e instalar o JDK de Java SE, pode-se testar se essas três
027        ferramentas estão instaladas executando-as em uma janela de prompt de 
028    comando. </p>       
029    <p> Abrindo uma janela de prompt de comando e digitando: </p>
030
031<p> java </p>
032
033<p> Caso esteja instalado, o programa será executado e escreverá seu modo de
034    usar (ajuda) na tela. </p>
035<p> Faz-se o mesmo com javadoc. </p>
036<p> Para testar javac é necessário saber onde o programa está instalado
037    e escrever o caminho completo para o programa. Em
038    meu computador está em \Program Files\Java\jdk1.8.0_25\bin, logo nele 
039    digita-se o caminho completo: \Program Files\Java\jdk1.8.0_25\bin\javac 
040</p>
041<p> No Linux instale o open-jdk. Se sua distribuição é Debian ou Ubuntu o
042    comando que faz isso é sudo apt-get install open-jdk-7-jdk. Caso seja
043        CentOS, RedHat, Fedora, sudo yum install open-jdk (ou algo próximo)
044        deve funcionar. Também pode instalar pelas interfaces gráficas como
045        Ubuntu Software Center ou Synaptic Package Manager. O teste é feito
046        no console, digitando java, javac e javadoc - deve mostrar o texto
047        de ajuda.</p>
048
049<p> Instalação testada, testar se funciona direito com o Olá Mundo -
050        Os passos para escrever e executar um programa escrito em Java são:
051<ol>
052    <li> Abrir um editor de texto; </li>
053    <li> digitar o programa (ver Código do Olá Mundo); </li>
054    <li> salvar o programa com o nome Ola.java em uma pasta conhecida; </li>
055    <li> Abrir prompt ou console; </li>
056    <li> Ir para a pasta (diretório) em que você salvou o programa; </li>
057    <li> Digitar na linha de comando: javac Ola.java;
058        (usar o caminho completo se necessário)</li>
059    <li> Digitar na linha de comando: java Ola </li>
060</ol>
061<p> Em tudo dando certo, o programa escreverá Olá Mundo! na tela. </p>
062<p> A chance de dar algo errado e você ter que recorrer a alguma ajuda é
063alta. Use este blog para trocar idéias. </p>
064<p> Espera-se que em várias partes desta leitura você tenha perguntado a razão
065    de fazer o que está aqui. Isso é saudável e desejável. Estranho
066    é fazer tudo sem saber o que é e sem se perguntar a razão, já que 
067        espera-se que você queira aprender programação... envie suas perguntas. 
068</p>
069        @author Fábio Nakano
070*/      
071public class Ola { // declara a classe de nome Ola
072        public static void main (String[] args) { // declara o método main
073                System.out.println ("Olá Mundo");
074        }
075}