Re: [shell-script] Formatação nos scripts

[Raul Libório]

Marlon meu brother, primeiramente, nao estou te corrigindo!

Mas sendo franco, eu não gosto muito dessa formatação, tipo, fazer linhas
com lasanha (ou a famosa cerquilha, fugueirinha, cruz-credo, '#' , e outros
), nao faço isso por questão de estética mesmo.

Geralmente costumo fazer linhas com linhas, usando ou '_' ou entao '-'. O
script fica mais limpo visualmente.
Outra coisa que costumo fazer tb é colocar apenas as informações que forem
necesssária a nele. Sempre sem usar sinais diacríticos, definindo variáveis
com letras maiúsculas e comandos em minúsculas.

Ah, quando digo que é estética, não ligue, é que sou viciado no Gimp e sabe
como é... tudo tem de sair realmente bonito e combinando :)

Eu nao quero ser chato e talz, mas é só minha humilde opnião :)

abraços,
--

Raul Libório
UniJorge Redes - www.redesfja.com
rauhmarutsªhotmailºcom
Linux user#4444581
[(55) 71] 9246 9828
/ `
/
.------.
|"""""""|
|Linux |
|inside|
`--------'
Dúvidas: enviar para /dev/null .
Respondei assim que possível."
_____________________________
"Nada se cria, tudo se compila."


2008/7/30 Marlon Vagner Reck <address@hidden>

>   Amigo
>
> Acho que a melhor forma seria vc escrever eles de forma q vc entenda eles
> mesmo depois de 20 anos ou mais.
> Eles precisam ser bonitos aos olhos, eficazes e fáceis de se dar
> manutenção,
> tipo cabeçario explicando o q o programa faz e exemplos de como usa-lo,
> comentários diretos e simples nas linhas onde vc acha necessário.
> Abaixo segue alguns pedaços de um script meu.
>
> Cabeçario:
>
> #!/bin/bash
>
> #######################################################
> # sargIndex
> #
> #Um programa para atualizar as index do Sarg através dos arquivos
> compactados
> #pelo tar.gz
> #
> #Exemplo de uso: ./sargIndex logSarg_170708.tar.gz
> #
> #As únicas configurações nescessárias são os locais dos arquivos:
> #DIR_SALVO= local onde foi salvo o arquivo de log compactado.
> #DIR_DIARIO= local onde estão os arquivos dos logs diários do sarg.
> #DIR_SEMANA= local onde estão os arquivos dos logs semanais do sarg.
> #
> #Criado em: 18/07/2008
> #
> #Atualizado por Marlon: 21/07/2008 (Corrigido o erro ao tentar mover mais
> de
> # uma pasta).
> #Atualizado por Marlon: 22/07/2008 (Corrigido o erro da falta do arquivo
> index).
> #
> #Autor: Marlon Reck
> #mail: address@hidden <marlonreck%40hotmail.com>
> #Licença: GPL
> ########################################################
>
> Linhas com comentários:
>
> #Váriaveis globais
> ARQUIVO="$1"
> DIR_SALVO=/mnt/hd/log/
> DIR_DIARIO=/mnt/hd/wwwroot/diario/
> DIR_SEMANA=/mnt/hd/wwwroot/semana/
> #Fim das váriaveis globais
>
> ....................
>
> #move os diretórios data(17jul2008-17jul2008) para o diretório da
> #váriavel DIR_DIARIO, o xargs aqui se compara ao find -exec.
> ls |egrep [-*]|xargs -I {} mv -f {} "$DIR_DIARIO"
>
> .......................
>
> Espero q estas linhas acima tenham ajudado e desculpem se o e-mail ficou
> grande.
> Ps. o script completo vai ficar aqui um mês :
> http://pastebin.com/m604ff8fa
>
> Marlon V. Reck
>
> Em Wednesday 30 July 2008 15:15:50 Tiago Barcellos Peczenyj escreveu:
>
> > Sempre escreva os seus scripts como se quem fosse usar e dar
> > manutenção no futuro fosse um psicopata que sabe aonde vc mora.
> >
> > changelog? dependendo da complexidade é util.
> > comentários? quando esclarecem são otimos
> > identação: obrigatorio!
> >
> > 2008/7/30 Raul Libório <address@hidden <rauhmaru%40gmail.com>>:
> > > Cara, pelo que sei, uma boa prática é sempre seguir as identações,
> > > colocar um changelog e dizer pra que serve o script no cabeçalho.
> > > Ai vc pode ir comentando o script com um padrão que você costuma
> > > utilizar, tipo, antes de um comando extenso, vc comentar o que ele vai
> > > fazer.... Vá simplifiquando a leitura de quem não conhece a função do
> seu
> > > script.
> > >
> > > abs!""
> > >
> > > --
> > >
> > > Raul Libório
> > > UniJorge Redes - www.redesfja.com
> > > rauhmarutsªhotmailºcom
> > > Linux user#4444581
> > > [(55) 71] 9246 9828
> > > / `
> > > /
> > > .------.
> > >
> > > |"""""""|
> > > |Linux |
> > > |inside|
> > >
> > > `--------'
> > > Dúvidas: enviar para /dev/null .
> > > Respondei assim que possível."
> > > _____________________________
> > > "Nada se cria, tudo se compila."
> > >
> > > 2008/7/30 Alicino De Moura Filho <address@hidden<alicino%40ymail.com>
> >
> > >
> > >> Colegas,
> > >>
> > >> Alguém poderia indicar um site ou algo que ajude a explicitar sobre a
> > >> formatação nos scripts que criamos?
> > >>
> > >> Digo isso, pq as vezes visualmente não fica legal e fico me
> perguntando
> > >> se existe uma "regra", mesmo que informal para isso.
> > >>
> > >> Abs!
> > >>
> > >> Alicino de Moura Filho
> > >> address@hidden <alicino%40ymail.com> <alicino%40ymail.com>
> > >> http://www.alicino.eng.br/
> > >> Campinas-SP
> > >>
> > >> --+ Mens In Corpore Tantum Molem Regit +--
> > >>
> > >> [As partes desta mensagem que não continham texto foram removidas]
> > >
> > > [As partes desta mensagem que não continham texto foram removidas]
>
> --
> Desde já agradeço.
> Marlon V. Reck
>  
>


[As partes desta mensagem que não continham texto foram removidas]