@returnとは : JavaA2Z
「戻り値」を出力するためのタグ。 Javadocのタグのひとつ。メソッドのドキュメンテーションコメント内に「@return 説明」と記述することで、Javadocによって出力されたメソッドの仕様に、「戻り値: 説明」という記述が出力される。 // Sample.java public class Sample { public static void main( String[] args ) { int result = toInt( "100" ); System.out.println( result ); // 100 } /** * 整数値に変換します。 * ↓これ。 * @return 変換後の整数値。 * @param string 変換前の文字列。"100"とか。 */ public static int toInt( String string ) { r
@paramとは : JavaA2Z
「引数」を出力するためのタグ。 Javadocのタグのひとつ。メソッドのドキュメンテーションコメント内に「@param 引数名 説明」と記述することで、Javadocによって出力されたメソッドの仕様に、「パラメータ: 引数名 - 説明」という記述が出力される。 // Sample.java public class Sample { /** * main()メソッド。<br> * 最初に呼ばれるメソッドです。 * ↓これ。 * @param args javaコマンド実行時に渡されるパラメーターが入っています。 */ public static void main( String[] args ) { int result = toInt( "100" ); System.out.println( result ); // 100 } } /* あとは、javadocコマン
/ - 海豹日記
{今年|今月|今週|今日}も何%過ぎました ゆく河の流れは絶えずして、しかももとの水にあらず (鴨長明:荘子) FESTINA LENTE ゆっくり急げ (ローマ帝国初代皇帝 アウグストゥス) 立派にできたのであれば、それは十分早くできたことになる (ローマ帝国初代皇帝 アウグストゥス) 海豹日記 へようこそ このサイトは、個人的な覚書を残しておくサイトです 自分は、よくこんなことをします 何かの困りごとや興味の赴くままに、いろいろ調べる 数か月後に、そのことを忘れてしまって、同じことについていろいろ調べる。しかし、そのうち、数か月前の自分が、同じことを同じように調べていたことに気づく それは不毛なので、覚書を残しておこうというわけです (主人公のアリスに掴まれて、チェス盤のはるかかなたまで持ち上げられたことのあるチェスの王さまが、当時のこと思い出し) 王さま「あの瞬間の恐怖といったら、わ
sphinx-quickstartの起動 — Sphinx 1.4.4 ドキュメント
sphinx-quickstartの起動¶ Sphinxのドキュメントセットを生成するのは、 sphinx-quickstart というプログラムです。これは次のように実行します: projectdir はSphinxドキュメンテーションディレクトリをあなたが配置したい場所に 設定します。もし projectdir を削除した場合、ファイルはデフォルトでは現在のディレクトリへ生成されます。 sphinx-quickstart スクリプトは次のようなオプションを持っています: -q, --quiet¶ Quietモードはオプションを定義する対話式ウィザードをスキップします。このオプションは -p, -a および -v オプションを必要します。 -h, --help, --version¶ 簡単な使い方やSphinxのバージョンを表示します。 構成オプション¶ --sep¶ 記述した場合、ソー
概要 — Sphinx 1.4.4 ドキュメント
A project Download 現在のバージョン: 1.4.4 Python Package Indexからソースコードをダウロードするか、以下のコマンドでインストールしてください: pip install -U Sphinx 疑問? 意見? Googleグループのsphinx-users グループへの参加 もしくは、FreeNodeの#sphinx-docチャンネルへどうぞ。 何か気づいたことがあれば、issue trackerを使用して報告することもできます。 Sphinxは知的で美しいドキュメントを簡単に作れるようにするツールです。Georg Brandlによって開発され、BSDライセンスのもとで公開されています。 このツールはもともと、新しいPythonのドキュメントの変換のために作られました。Pythonのプロジェクトのためのすばらしい機能を提供してきましたが、現在ではC/
Pythonのメソッドと引数(pydocだけで書いてみた) - Block Rockin’ Codes
# -*- coding:utf-8 -*- ''' ================================= Pythonのメソッドと引数 ================================= :Author: Jxck :Created: 2010/06/04 :Tags: python method argment :Ripositly: https://jxck@bitbucket.org/jxck/python-args :abstract: pythonは引数は色々な渡し方ができます。 メソッドの設計の時思い出せるようちょっとまとめときます。 doctestの方が分かりやすいと思い、記事自体pydocで書いてみました。 上手く使えばメソッドの設計をすっきりさせたりできます。 引数の設計はインタフェースの設計。 インタフェースの設計は、 ユーザビリティとテ
Sphinx で自動的にAPIリファレンスを作成したい - Study08.net 対シンバシ殲滅用人型機動兵器
今日はこのネタです。タイトルの通りなんですが、PythonでそもそもAPIリファレンス的なドキュメントをどうやって作ったら良いのか知りませんでした。 他の言語であれば下記のようなツールを過去に使った事がありました。 Java なら Javadoc Perl なら pod2html PHP なら PHPDocumentor (今ならもっと賢いツールありそうだけど。。。) Pythonなら? ではPythonであればどのような選択肢があるでしょう。調べた限りではまず下記のような選択肢がありました。 pydoc -w でHTML生成 (pydocで簡単なPythonファイルのドキュメントを作成する) Epydocを利用する (Epydoc - 偏った言語信者の垂れ流し) javadocやらphpdocmentorやらのように、まるっとソースからHTMLを生成するだけであれば、これで十分かもしれま
25.1. pydoc — Documentation generator and online help system — Python 2.7.18 documentation
This document is for an old version of Python that is no longer supported. You should upgrade and read the Python documentation for the current stable release. Source code: Lib/pydoc.py The pydoc module automatically generates documentation from Python modules. The documentation can be presented as pages of text on the console, served to a Web browser, or saved to HTML files. For modules, classes,
Pythonの日付処理とTimeZone | Nekoya press
日付周りの処理というのはとても難しい問題で、特にTimeZoneが絡むと基本的に大変なことになります。 Pythonは標準で用意されているdatetimeモジュールが高機能なので、それを使っておけば間違いない感があって、そういう意味では安心感があります。 とは言え、その扱いにはやはり注意が必要で、現時点でこうするのがいいかなーと思っていることをつらつらと記録したエントリがこちらです。 基本的にはMacのPython2.7.1で検証して、おやっと思ったところはCentOS5.8のPython2.6.5やUbuntu12.04のPython2.7.3で追試しています。 なお、datetime.datetimeと書くのがだるいので本文中では、 from datetime import datetime を前提としています。 naiveとaware 公式ドキュメントにそのまま載ってるけど、date
なぜ html の form は PUT / DELETE をサポートしないのか？ - Block Rockin’ Codes
注意 内容については一切保証しません。 ここでは、主に W3C ML での議論や各種仕様などに基づいて書いています。 ここに書かれていることが正しいかどうかは、自身で判断して下さい。 事実としておかしいところなどは、コメントでどんどん指摘して下さい。遠慮はいりません。 ただし、このエントリでは「form が PUT/DELETE をサポートするべきかどうか？」の議論はしません。 「REST の是非」や「PUT/DELETE の意義」についても議論する気はありません。 ここでやっているのは、あくまでもどういった議論の末現状があるのかの調査です。 そうした意見がある場合は、 W3C などに投稿するのが最も有益だと思います。 History 2014/03/29: 公開 2014/03/29: XForm と XHTML の関係を明確化(thanx koichik) 2014/03/29: HT
独創的PR会社おくりバント、Twitterで話題の黒ギャル“はるたむ”のネイルに大ヒットパズルゲーム「キャンディークラッシュ」の広告を掲載
広告概要は以下のとおりです。 ■広告商品名 はるたむフィンガージャック（品番HFJ-10） (デコパーツ部分を、広告主ご要望のロゴやキャラクターに変更することができます。) ■掲載期間 最低保証2週間～ネイルが取れるまで（通常1ヶ月程度） ■入稿規定 “はるたむ”本人がかわいいと感じたもの ■露出箇所 ・プレスリリース配信（各ニュースサイトでの掲載が期待されます） ・“はるたむ”のTwitter（フォロワー約7,500人）やブログ（デイリー約1万PV） ・「black diamond」メンバーとして、テレビ等メディア出演する際の映り込み ■掲載イメージ ■“はるたむ”Twitter URL：http://pic.twitter.com/Nv5tmifdcy 今後もおくりバントは、顧客のニーズに柔軟に対応し、創造的かつ独創的なプロモーションを行うべく尽力してまいります。 ※Google pl
Railsでのdelayed_jobの設定｜DIGITAL SQUADブログ
Railsでのdelayed_jobの設定 Railsでのdelayde_jobの設定メモ Railsでdelayed_jobを利用する場合の手順メモ。Railsのバージョンは2.2.2。 Rails2系でのdelayed_jobはrubygemsの依存関係を見ると2.3以上は２.0.7、それ以下は2.0.6となっているが、Rails 2.2.2で2.0.6はscript/generate delayed_job Couldn't find 'delayed_job' generatorとなってgeneratorが作れないので、2.0.4を使用した。 ちなみに、delayed_jobのオリジナルはhttps://github.com/tobi/delayed_jobらしいが、メンテされていて高機能な https://github.com/collectiveidea/delayed_job
constant Object::ARGV (Ruby 1.8.7)
ARGV -> Array[permalink][rdoc] Ruby スクリプトに与えられた引数を表す配列です。 組み込み変数 $* の別名です。 Ruby 自身に対する引数は取り除かれています。 例: スクリプト argv.rb の内容が p ARGV であったとします。このときシェルから次を実行すると、 $ ruby argv.rb foo bar baz 結果は以下のように出力されます。 ["foo", "bar", "baz"] ARGV -> Array[permalink][rdoc] [redefined by optparse] Ruby スクリプトに与えられた引数を表す配列です。 optparse を require することにより、ARGV は OptionParser::Arguable を Object#extend します。 [SEE_ALSO] OptionP
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
python のコメントの書き方 (ハズレ日記)
layer8.sh
GitHub - sgymtic/sl: SL(1): Cure your bad habit of mistyping
Git で特定のコミットだけをマージする – DeVlog – 銀の翼で翔べ –
ONLINE138 : Yuk Join Best Gaming Online Server Infini 138 No 1 Pasti WD
GitHub - yegappan/mru: Most Recently Used (MRU) Vim Plugin
GitHub - collectiveidea/delayed_job: Database based asynchronous priority queue system -- Extracted from Shopify
