diff options
Diffstat (limited to 'brweather/doc')
-rw-r--r-- | brweather/doc/Changelog | 16 | ||||
-rw-r--r-- | brweather/doc/brweather.conf.default | 6 | ||||
-rw-r--r-- | brweather/doc/help | 2 | ||||
-rw-r--r-- | brweather/doc/help-default | 2 | ||||
-rw-r--r-- | brweather/doc/man | 429 | ||||
-rw-r--r-- | brweather/doc/version | 2 |
6 files changed, 448 insertions, 9 deletions
diff --git a/brweather/doc/Changelog b/brweather/doc/Changelog index 0655b01..27dca21 100644 --- a/brweather/doc/Changelog +++ b/brweather/doc/Changelog @@ -2,6 +2,21 @@ # Changelog das versões do BrWeather # Criado por LeandroNKZ +### Versão 0.6.0 (lançada em 31-03-2013) ### +- Melhora na performance; +- Inclusão do módo Híbrido: ele mescla opções do INPE e Open Weather, e é +indicado para as cidades que não possuem opções de previsão completas. +- Opções de configuração avançadas (apenas para usuários experientes): + - Estas configurações estão presentes no arquivo executável principal: brweather + - DIRNAME - Diretório base: pode-se alterar a pasta de instalação do BrWeather (fora + de /opt) - Créditos ao usuário rhatto pela implementação; + - TIME_COUNT - Timer para apagar arquivos de logs: alterar o tempo de intervalo para a + exclusão dos arquivos de log antigos; + - ROOT - Permite execução pelo usuário root (1=sim ; 0=não): +- Aumento do cache de fases da Lua para até 2023. + + + ### Versão 0.5.0 (lançada em 25-11-2012) ### - Alteração nos temas de imagens: - Acréscimo de mais dois temas de imagens; @@ -17,7 +32,6 @@ e que deve ser instalado à parte e opcionalmente; --mode Ela exibe qual o modo que está ativo (INPE ou OPEN). - ### Versão 0.4.0-rc4-extra4 (lançada em 21-10-2012) ### - Correção do Bug #010: Falha ao utilizar as opções de temperatura (entre outras do modo OPEN. diff --git a/brweather/doc/brweather.conf.default b/brweather/doc/brweather.conf.default index 23c8de2..971e114 100644 --- a/brweather/doc/brweather.conf.default +++ b/brweather/doc/brweather.conf.default @@ -13,6 +13,8 @@ # Escolha: # "0" = ATIVAR o serviço Nacinal INPE. # "1" = DESATIVAR o INPE e utilizar APENAS o serviço internacional Open Weather. +# "2" = ATIVAR o modo Híbrido. Mais informações aqui: +# http://brweatherproject.blogspot.com/2012/06/configuracao-do-brweather.html OPEN="0" # Escolha o tempo de espera (em segundos) para a conexão. @@ -40,6 +42,7 @@ CODIGO="UTF-8" # o BrWeather utiliza o serviço de meteorologia do CPTEC/INPE (Instituto Nacional de Pesquisas Espaciais). # Nota: Preencha o campo abaixo, apenas se estiver utilizando o serviço nacional. # Se estiver utilizando apenas o Open Weather pule para o campo "Serviço Internacional". +# Se estiver utilizando o modo Híbrido, este campo é obrigatório # CPTEC/INPE # Acesse o site: @@ -62,7 +65,8 @@ CPTEC_INPE="2247" ### Serviço Internacional ### -# Importante: Não é necessário preencher estes campos se você utiliza somente o serviço nacional. +# Importante: Não é necessário preencher estes campos se você utiliza somente o serviço nacional +# Se utiliza o modo Híbrido, este campo é obrigatório # Acesse o site: http://openweathermap.org # Procure pela sua cidade no mapa, e clique no ícone de previsão da mesma # Assim que abrir a página com a previsão completa, veja que na barra de URL constará um código númérico. diff --git a/brweather/doc/help b/brweather/doc/help index 5cf6596..8f16aa4 100644 --- a/brweather/doc/help +++ b/brweather/doc/help @@ -30,7 +30,7 @@ Do programa: Exibe opções do serviço Open Weather --mode - Retorna o modo que está ativo (INPE ou OPEN) + Retorna o modo que está ativo (INPE, OPEN ou HÍBRIDO) Imagens diff --git a/brweather/doc/help-default b/brweather/doc/help-default index fccd4e1..ff7e7d4 100644 --- a/brweather/doc/help-default +++ b/brweather/doc/help-default @@ -29,7 +29,7 @@ Condições atuais Temperatura atual --option=umid - Nível de humidade + Nível de umidade --option=PA Nível de pressão atmosférica diff --git a/brweather/doc/man b/brweather/doc/man index 44ac695..ff505ab 100644 --- a/brweather/doc/man +++ b/brweather/doc/man @@ -1,4 +1,4 @@ -.TH BrWeather 1 2012-11-21 +.TH BrWeather 1 2013-03-30 .\" Please adjust this date whenever revising the manpage. .SH NOME BrWeather @@ -7,6 +7,49 @@ BrWeather .SH DESCRIÇÃO O BrWeather exibe a previsão do tempo no seu Conky. Ele utiliza os dados do serviço de meteorologia CPTEC/INPE. Além de, opcionalmente, apenas do Open Weather. + +.SH MODOS DE USO +.PP +.B MODO INPE +- O modo padrão de uso do programa. Ele é destinado às cidades que possuem previsão +completa no site do INPE (vide sessão INFORMAÇÕES, no final deste manual). +Utilize a opção 0 no arquivo de configuração: +.TP +OPEN="0" +.TP +E preencha o campo correspondente com o código de sua cidade: +.TP +CPTEC_INPE="código_do_inpe" +.PP +.B MODO OPEN +- O modo alternativo. Ele utiliza os dados do OpenWeather (vide sessão INFORMAÇÕES) +para exibir a previsão. É destinado às cidades que não constam no site do INPE, ou +que constam, mas não possuem a previsão completa (com condições atuais, como +Sensação térmica, temperatura atual, umidade relativa atual etc). +Utilize a opção 1 no arquivo de configuração: +.TP +OPEN="1" +.TP +E preencha o campo correspondente com o código de sua cidade: +.TP +OPEN_ID="código_do_open" +.PP +.B MODO HÍBRIDO +- O modo híbrido. Ele mescla os dados dos modos INPE e OPEN. É destinado àquelas +cidades que constam no site do INPE, porém, não possuem a previsão completa (com +dados de condições atuais). +Utilize a opção 2 no arquivo de configuração: +.TP +OPEN="2" +.PP +E preencha os campos dos dois modos: + +CPTEC_INPE="código_do_inpe" +.TP +OPEN_ID="código_do_open" + + + .SH OPÇÕES GERAIS DO PROGRAMA .TP .B \-\-version @@ -24,6 +67,9 @@ Menu de ajuda para o serviço nacional (INPE) .B \-\-help-open Menu de ajuda para o serviço Open Weather .TP +.B \-\-help-hibrido +Menu de ajuda para o modo hibrido +.TP .B \-\-man Este manual .TP @@ -40,7 +86,7 @@ Mostra o número de opções disponíveis para a utilização de imagens. Exibe o arquivo de mudanças entre as versões. .TP .B \-\-mode -Mostra qual dos modos está ativo no momento (INPE ou OPEN). +Mostra qual dos modos está ativo no momento (INPE, OPEN ou HÍBRIDO). .SH OPÇÕES DE IMAGENS .TP .B \-\-imagem(Numero)=CN @@ -755,15 +801,390 @@ Quantidade de nuvens (em %) .TP .B \-\-option=PA7 Nível de pressão atmosférica + + +.SH OPÇÕES DO MODO HÍBRIDO (MESCLA DADOS DO INPE E OPEN WEATHER) +.TP +.B \-\-option=city +Cidade +.TP +.B \-\-option=date +Data atual +.TP +.B \-\-option=Day0 +Dia de Hoje. Nome abreviado. Ex.: Sáb +.TP +.B \-\-option=Day0T +Hoje, nome completo. Ex.: Sábado +.TP +.B \-\-option=LU +Last update (última atualização) +.TP +.B \-\-option=LUS +Last update do servidor (última atualização do site) +.TP +.B \-\-option=CNT +Tempo atual modo texto (por extenso) +.TP +.B \-\-option=CNI +Tempo atual modo ícone (necessita de fonte weather instalada) +.TP +.B \-\-option=TN +Temperatura atual +.TP +.B \-\-option=umid +Nível de umidade atual +.TP +.B \-\-option=winds +Força do vento +.TP +.B \-\-option=PA +Nível de pressão atmosférica +.TP +.B \-\-option=UVN +Nível de Radiação ultravioleta +.TP +.B \-\-option=UVNT +Nível de Radiação ultravioleta modo texto. Ex.: Moderado, Baixo. +.TP +.B \-\-option=CLD +Quantidade de nuvens (em %) + + +.SH Previsão para as próximas horas +.TP +.B \-\-option=Day1 +Próximas horas (pode ser hoje, ou amanhã) +.TP +.B \-\-option=Day1T +Próximas horas, nome completo. Ex.: Sábado +.TP +.B \-\-option=C1T +Previsão as próximas horas (modo texto) +.TP +.B \-\-option=C1I +Previsão para as próximas horas (modo ícone) +.TP +.B \-\-option=LT1 +Temperatura mínima +.TP +.B \-\-option=HT1 +Temperatura máxima +.TP +.B \-\-option=PC1 +Probabilidade de chuva (em %) +.TP +.B \-\-option=UV1 +Previsão de nível de radiação ultravioleta +.TP +.B \-\-option=UV1T +Previsão de nível de radiação ultravioleta (nome completo. Ex.: moderada, baixa) +.TP +.B \-\-option=SOLN1 +Nascer do SOL (horário) +.TP +.B \-\-option=SOLP1 +Por do SOL (horário) +.TP +.B \-\-option=umid1 +Previsão do nível de umidade +.TP +.B \-\-option=CLD1 +Quantidade de nuvens (em %) +.TP +.B \-\-option=PA1 +Nível de pressão atmosférica + + +.SH Previsão para o segundo dia +.TP +.B \-\-option=Day2 +Segundo dia +.TP +.B \-\-option=Day2T +Segundo dia. Completo. Ex.: Sábado +.TP +.B \-\-option=LT2 +Temperatura mínima para segundo dia +.TP +.B \-\-option=HT2 +Temperatura máxima para segundo dia +.TP +.B \-\-option=C2T +Previsão para o segundo dia (modo texto) +.TP +.B \-\-option=C2I +Previsão para o segundo dia (modo ícone) +.TP +.B \-\-option=PC2 +Probabilidade de chuva (em %) +.TP +.B \-\-option=UV2 +Previsão de nível de radiação ultravioleta +.TP +.B \-\-option=UV2T +Previsão de nível de radiação ultravioleta (nome completo. Ex.: moderada, baixa) +.TP +.B \-\-option=SOLN2 +Nascer do SOL (horário) +.TP +.B \-\-option=SOLP2 +Por do SOL (horário) +.TP +.B \-\-option=umid2 +Previsão do nível de umidade +.TP +.B \-\-option=CLD2 +Quantidade de nuvens (em %) +.TP +.B \-\-option=PA2 +Nível de pressão atmosférica + + +.SH Previsão para o terceiro dia +.TP +.B \-\-option=Day3 +Terceiro dia +.TP +.B \-\-option=Day3T +Terceiro dia. Completo. Ex.: Sábado +.TP +.B \-\-option=LT3 +Temperatura mínima +.TP +.B \-\-option=HT3 +Temperatura máxima +.TP +.B \-\-option=C3T +Previsão para o terceiro dia (modo texto) +.TP +.B \-\-option=C3I +Previsão para o terceiro dia (modo ícone) +.TP +.B \-\-option=PC3 +Probabilidade de chuva (em %) +.TP +.B \-\-option=UV3 +Previsão de nível de radiação ultravioleta +.TP +.B \-\-option=UV3T +Previsão de nível de radiação ultravioleta (nome completo. Ex.: moderada, baixa) +.TP +.B \-\-option=SOLN3 +Nascer do SOL (horário) +.TP +.B \-\-option=SOLP3 +Por do SOL (horário) +.TP +.B \-\-option=umid3 +Previsão do nível de umidade +.TP +.B \-\-option=CLD3 +Quantidade de nuvens (em %) +.TP +.B \-\-option=PA3 +Nível de pressão atmosférica + + +.SH Previsão para o quarto dia +.TP +.B \-\-option=Day4 +Quarto dia +.TP +.B \-\-option=Day4T +Quarto dia. Completo. Ex.: Sábado +.TP +.B \-\-option=LT4 +Temperatura mínima para quarto dia +.TP +.B \-\-option=HT4 +Temperatura máxima para quarto dia +.TP +.B \-\-option=C4T +Previsão para o quarto dia (modo texto) +.TP +.B \-\-option=C4I +Previsão para o quarto dia (modo ícone) +.TP +.B \-\-option=PC4 +Probabilidade de chuva (em %) +.TP +.B \-\-option=UV4 +Previsão de nível de radiação ultravioleta +.TP +.B \-\-option=UV4T +Previsão de nível de radiação ultravioleta (nome completo. Ex.: moderada, baixa) +.TP +.B \-\-option=SOLN4 +Nascer do SOL (horário) +.TP +.B \-\-option=SOLP4 +Por do SOL (horário) +.TP +.B \-\-option=umid4 +Previsão do nível de umidade +.TP +.B \-\-option=CLD4 +Quantidade de nuvens (em %) +.TP +.B \-\-option=PA4 +Nível de pressão atmosférica + + +.SH Previsão para o quinto dia +.TP +.B \-\-option=Day5 +Quinto dia +.TP +.B \-\-option=Day5T +Quinto dia. Completo. Ex.: Sábado +.TP +.B \-\-option=LT5 +Temperatura mínima para quinto dia +.TP +.B \-\-option=HT5 +Temperatura máxima para quinto dia +.TP +.B \-\-option=C5T +Previsão para o quinto dia (modo texto) +.TP +.B \-\-option=C5I +Previsão para o quinto dia (modo ícone) +.TP +.B \-\-option=PC5 +Probabilidade de chuva (em %) +.TP +.B \-\-option=UV5 +Previsão de nível de radiação ultravioleta +.TP +.B \-\-option=UV5T +Previsão de nível de radiação ultravioleta (nome completo. Ex.: moderada, baixa) +.TP +.B \-\-option=SOLN5 +Nascer do SOL (horário) +.TP +.B \-\-option=SOLP5 +Por do SOL (horário) +.TP +.B \-\-option=umid5 +Previsão do nível de umidade +.TP +.B \-\-option=CLD5 +Quantidade de nuvens (em %) +.TP +.B \-\-option=PA5 +Nível de pressão atmosférica + + +.SH Previsão para o sexto dia +.TP +.B \-\-option=Day6 +Sexto dia +.TP +.B \-\-option=Day6T +Sexto dia. Completo. Ex.: Sábado +.TP +.B \-\-option=LT6 +Temperatura mínima para sexto dia +.TP +.B \-\-option=HT6 +Temperatura máxima para sexto dia +.TP +.B \-\-option=C6T +Previsão para o sexto dia (modo texto) +.TP +.B \-\-option=C6I +Previsão para o sexto dia (modo ícone) +.TP +.B \-\-option=PC6 +Probabilidade de chuva (em %) +.TP +.B \-\-option=UV6 +Previsão de nível de radiação ultravioleta +.TP +.B \-\-option=UV6T +Previsão de nível de radiação ultravioleta (nome completo. Ex.: moderada, baixa) +.TP +.B \-\-option=SOLN6 +Nascer do SOL (horário) +.TP +.B \-\-option=SOLP6 +Por do SOL (horário) +.TP +.B \-\-option=umid6 +Previsão do nível de umidade +.TP +.B \-\-option=CLD6 +Quantidade de nuvens (em %) +.TP +.B \-\-option=PA6 +Nível de pressão atmosférica + + +.SH Previsão para o sétimo dia +.TP +.B \-\-option=Day7 +Sétimo dia +.TP +.B \-\-option=Day7T +Sétimo dia. Completo. Ex.: Sábado +.TP +.B \-\-option=LT7 +Temperatura mínima para sétimo dia +.TP +.B \-\-option=HT7 +Temperatura máxima para sétimo dia +.TP +.B \-\-option=C7T +Previsão para o sétimo dia (modo texto) +.TP +.B \-\-option=C7I +Previsão para o sétimo dia (modo ícone) +.TP +.B \-\-option=PC7 +Probabilidade de chuva (em %) +.TP +.B \-\-option=UV7 +Previsão de nível de radiação ultravioleta +.TP +.B \-\-option=UV7T +Previsão de nível de radiação ultravioleta (nome completo. Ex.: moderada, baixa) +.TP +.B \-\-option=SOLN7 +Nascer do SOL (horário) +.TP +.B \-\-option=SOLP7 +Por do SOL (horário) +.TP +.B \-\-option=umid7 +Previsão do nível de umidade +.TP +.B \-\-option=CLD7 +Quantidade de nuvens (em %) +.TP +.B \-\-option=PA7 +Nível de pressão atmosférica + + .SH ARQUIVO DE CONFIGURAÇÃO .TP /home/seu_usuário/.brweather.conf + + .SH AUTOR -BrWeather foi orgulhosamente desenvolvido por: +BrWeather foi orgulhosamente desenvolvido e trazido até você por: .TP LeandroNKZ <leandronkz@gmail.com>. + +.SH COPYRIGHT +Este software é fornecido "no estado em que se encontra", não havendo quaisquer +garantias por parte do desenvolvedor. +.TP +O BrWeather é distribuído sob a licença GPLv3: +http://www.gnu.org/licenses/gpl-3.0.html + .SH INFORMAÇÕES -Este manual foi escrito pelo próprio desenvolvedor. Quaisquer erros, ou BUGs no programa, favor relatar ao autor. Este autor não se responsabiliza por eventuais prejuízos causados por este software. +Este manual foi escrito pelo próprio desenvolvedor. Quaisquer erros, ou BUGs no programa, favor relatar ao autor. .TP Visite o blog oficial para mais informações, tutoriais e dicas: .TP diff --git a/brweather/doc/version b/brweather/doc/version index 8f0916f..a918a2a 100644 --- a/brweather/doc/version +++ b/brweather/doc/version @@ -1 +1 @@ -0.5.0 +0.6.0 |