Perguntas com a marcação «doc»

864
Como referenciar um método em javadoc?

Como posso usar a @linktag para vincular a um método? Eu quero mudar: /** * Returns the Baz object owned by the Bar object owned by Foo owned by this. * A convenience method, equivalent to getFoo().getBar().getBaz() * @return baz */ public Baz fooBarBaz() para: /** * Returns the Baz object...

631
Como "cat << EOF" funciona no bash?

Eu precisava escrever um script para inserir entrada de várias linhas em um programa ( psql). Depois de pesquisar um pouco, descobri que a seguinte sintaxe funciona: cat << EOF | psql ---params BEGIN; `pg_dump ----something` update table .... statement ...; END; EOF Isso constrói...

417
Dica do tipo PHPDoc para array de objetos?

Portanto, no PHPDoc, pode-se especificar @varacima da declaração da variável membro para sugerir seu tipo. Então um IDE, por exemplo. O PHPEd saberá com que tipo de objeto está trabalhando e poderá fornecer uma visão do código para essa variável. <?php class Test { /** @var SomeObj */...

374
Como atribuir um valor heredoc a uma variável no Bash?

Eu tenho essa sequência de várias linhas (aspas incluídas): abc'asdf" $(dont-execute-this) foo"bar"'' Como atribuiria a uma variável usando um heredoc no Bash? Eu preciso preservar novas linhas. Eu não quero escapar dos caracteres da string, isso seria irritante

316
Como descrever argumentos de "objeto" no jsdoc?

// My function does X and Y. // @params {object} parameters An object containing the parameters // @params {function} callback The callback function function(parameters, callback) { } Mas como descrevo como o objeto de parâmetros deve ser estruturado? Por exemplo, deve ser algo como: { setting1...

254
Como anexar javadoc ou fontes a jars na pasta libs?

A nova versão do plug-in ADT r17 para Eclipse adicionou o recurso para configurar automaticamente as dependências JAR. Todos os arquivos .jar na pasta / libs são adicionados à configuração de compilação agora. Infelizmente, o contêiner do caminho de classe das Dependências do Android não é...

230
Javadoc: package.html ou package-info.java

Ao tentar criar comentários Javadoc no nível do pacote, qual é o método preferido? O que você faz? package-info.java Prós Mais recentes Contras Abuso de classe - Classes são para código, não apenas para comentários package.html Prós Extensão HTML significa que não é código Destaque...

196
Qual é a vantagem de usar o heredoc no PHP? [fechadas]

Atualmente, essa questão não se encaixa no nosso formato de perguntas e respostas. Esperamos que as respostas sejam apoiadas por fatos, referências ou conhecimentos, mas essa pergunta provavelmente solicitará debate, argumentos, pesquisas ou discussão prolongada. Se você acha que...

192
Usando variáveis ​​dentro de um heredoc bash

Estou tentando interpolar variáveis ​​dentro de um heredoc bash: var=$1 sudo tee "/path/to/outfile" > /dev/null << "EOF" Some text that contains my $var EOF Isso não está funcionando como eu esperaria ( $varé tratado literalmente, não expandido). Eu preciso usar sudo teeporque a criação...