Pertanyaan yang diberi tag doc

864
Bagaimana cara mereferensikan metode di javadoc?

Bagaimana saya bisa menggunakan @linktag untuk menautkan ke suatu metode? Saya ingin berubah: /** * 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() untuk: /**...

631
Bagaimana cara "cat << EOF" bekerja di bash?

Saya perlu menulis skrip untuk memasukkan input multi-line ke suatu program ( psql). Setelah sedikit googling, saya menemukan sintaks berikut berfungsi: cat << EOF | psql ---params BEGIN; `pg_dump ----something` update table .... statement ...; END; EOF Ini benar membangun string...

531
Contoh beberapa kode baris dalam komentar Javadoc

Saya punya contoh kode kecil yang ingin saya sertakan dalam komentar Javadoc untuk suatu metode. /** * -- ex: looping through List of Map objects -- * <code> * for (int i = 0; i < list.size(); i++) { * Map map = (Map)list.get(i); * System.out.println(map.get("wordID")); *...

417
Petunjuk jenis PHPDoc untuk array objek?

Jadi, di PHPDoc kita dapat menentukan di @varatas deklarasi variabel anggota untuk mengisyaratkan pada tipenya. Kemudian sebuah IDE, misalnya. PHPEd, akan tahu jenis objek apa yang bekerja dengannya dan akan dapat memberikan wawasan kode untuk variabel itu. <?php class Test { /** @var...

374
Bagaimana cara menetapkan nilai heredoc ke variabel di Bash?

Saya memiliki string multi-baris ini (termasuk kutipan): abc'asdf" $(dont-execute-this) foo"bar"'' Bagaimana saya menetapkannya ke variabel menggunakan heredoc di Bash? Saya perlu mempertahankan baris baru. Saya tidak ingin lepas dari karakter dalam string, itu akan mengganggu...

316
Bagaimana cara menggambarkan argumen "objek" di jsdoc?

// My function does X and Y. // @params {object} parameters An object containing the parameters // @params {function} callback The callback function function(parameters, callback) { } Tetapi bagaimana saya menggambarkan bagaimana objek parameter harus disusun? Contohnya harus seperti: { setting1...

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

Ketika mencoba membuat komentar Javadoc tingkat paket, apa metode yang disukai? Apa yang kamu kerjakan? package-info.java Pro Lebih baru Cons Penyalahgunaan kelas - Kelas adalah untuk kode, bukan hanya untuk komentar package.html Pro Ekstensi HTML berarti bukan kodenya Menyoroti...

196
Apa keuntungan menggunakan heredoc di PHP? [Tutup]

Seperti yang ada saat ini, pertanyaan ini tidak cocok untuk format Tanya Jawab kami. Kami berharap jawaban didukung oleh fakta, referensi, atau keahlian, tetapi pertanyaan ini kemungkinan akan mengundang debat, argumen, polling, atau diskusi panjang. Jika Anda merasa bahwa

192
Menggunakan variabel di dalam heredoc bash

Saya mencoba menginterpolasi variabel di dalam heredoc bash: var=$1 sudo tee "/path/to/outfile" > /dev/null << "EOF" Some text that contains my $var EOF Ini tidak berfungsi seperti yang saya harapkan ( $vardiperlakukan secara harfiah, tidak diperluas). Saya perlu menggunakan sudo...