Jenkinsのビルド後にgh-pagesにpushする - くりにっき
以前書いた GithubのリポジトリでJavaDocを公開する - sue445's Blog というエントリでJavaDocをgh-pagesに公開する方法書いていましたが、それをJenkinsで自動化してみます。 0. 前提 上記のエントリを参考にmavenでJavaDocが作られるようにしておいてください 1. Post build task pluginをインストールする Jenkinsのビルド終了後に任意のスクリプトを実行するためのプラグイン Post build task - hudson - Hudson Wiki 2. gh-pagesにpushするスクリプトをワークスペースに入れる https://github.com/sue445/s3tiger/blob/master/script/deploy-gh-pages.sh を参考に。REPO_URLの部分は適宜変えてくだ
Java SE 日本語ドキュメントの置き場所 - torutkのブログ
職場で隣席の同僚から、Java SEの日本語ドキュメントどこでしたっけ？ と聞かれてとっさに回答できませんでした。 昔はJDKダウンロードサイトのドキュメントのところに英語版と日本語版が並んでいたのですが、現在はU.S. Oracleのサイトではなく、日本オラクルのサイトに置かれています。 Webを検索してもなかなか一発では辿りつけないので、辿る道筋をちょっとメモしておきます。 まず、OTN Japan（Oracel Technology Network）のトップページに行きます（次のURL）。 http://www.oracle.com/technetwork/jp/index.html 次に、このページの割と上にある[Javaテクノロジー]のリンクを辿ります。画面キャプチャを次に示します。 [Javaテクノロジー]リンクを辿ると次のURLとなります。ここは日本オラクルの技術者向けJav
Java SE 7 Update 65とJava SE 8 Update 11に更新（Windows） - torutkのブログ
はじめに Windows上で、Java SE Development Kit（JDK）のバージョンアップ作業をしました、という日記です。 JREの期限 Java SE 8u5でAppletを実行しようとしたところ、Javaが期限切れのため実行できませんでした*1。ここでいう期限とは、WebブラウザからJavaを実行する際のJavaプラグインのセキュリティアップデートに設けられた期限を指しています。Java SE 8 Update 11の場合、JDK 8u11 Updateのリリースノートの"JRE Expiration Date"項に期限について次のように述べられています。 セキュリティ脆弱性の修正を含む新しいアップデート（CPU: Critical Patch Update）がリリースされた時点で期限切れとなります。次回のCPUリリース予定は2014年10月14日です。 Oracle社の
Java Advent Calendar 2013 11日目 - Java SE 8の新クラス・メソッド一覧 - torutkのブログ
2013年のJava Adventカレンダーの11日目のエントリーです。 前日のエントリーは、Satoyuki Tsukanoさんのtwitterとelasticsearchを簡単に連携させる(Apache Camel入門 その2 コンポーネントについて) - Taste of Tech Topics、 明日はkisさんです。 はじめに メジャーバージョンアップとなるJava SE 8が年明けの3月に正式版リリース（GA:General Availability）を迎えます。メジャーバージョンアップでは、目玉機能には注目が集まるのであちこちでその内容が紹介されます。たとえば、Java SE 8ではラムダ式とStream API、Date and Time APIなどが目玉機能となります。これらの記事はすでにあちこちで見かけますね。 一方、既存APIへのクラス・メソッドの追加は地味なので注目
新しい Java SE API リファレンスの入手先について
新しい Java SE API リファレンスの入手先について 2012年3月25日 at 10:30 午後 3件のコメント 2012 年 03 月 25 日、sun.com のドメインが利用不可になりました。これに併せ、java.sun.com で提供されていた Java SE API 日本語ドキュメントもオンライン経由で参照する事ができなくなりました。今後、日本語の Java SE API レファレンスはオンライン経由では参照できなくなりますので、アーカイブを御入手の上、ローカル環境でご参照ください。お手数をお掛けし申し訳ございませんが、どうぞ宜しくお願いします。 Java API の日本語ドキュメントはコチラから入手が可能です。 ドキュメントの再配布ポリシーはコチラをご参照ください。 新しい日本語 API ドキュメントのオンライン参照先URL (2012/4/11 訂正、追記) htt
Ｊａｖａ ＳＥ７ＡＰＩ日本語版提供開始
2013年5月14日 at 7:47 午後 6件のコメント 2013 年 5 月 14 日、日本オラクルより新しい発表を行います。本日 5 月 14 日に日本語版 Java SE API ドキュメントを正式公開しました。 「Java Platform, Standard Edition 7」の最新情報を記載したドキュメント類の日本語版を本日公開しました。 公開先URL：http://www.oracle.com/technetwork/jp/java/javase/documentation/ ・本日公開した「Java Platform, Standard Edition 7」の最新ドキュメントは、2011年7月に提供開始した「Java Platform, Standard Edition 7 (Java SE 7)」が提供する機能紹介、コンポーネント一覧を記載した参照資料です。Java開
Ant「javadoc」メモ(Hishidama's ant-javadoc Memo)
例 複数のディレクトリーからJavadocを生成する例。 →生成されたJavadoc build.xml： <?xml version="1.0" encoding="Shift_JIS"?> <project name="javadoc" default="javadoc" basedir="."> <target name="javadoc"> <native2ascii src="." dest="." ext=".properties"> <include name="docdata.txt" /> </native2ascii> <property file="docdata.properties" /> <property name="overview" location="../src/overview.html" /> <property name="doc" locati
コメント不要論の補足 - ひしだまの変更履歴
ひしだまＨＰの更新履歴。 主にＴＲＰＧリプレイの元ネタ集、プログラミング技術メモと自作ソフト、好きなゲームや音楽です。 コメント不要論の部分、言葉足らずでまとまりを欠いている気がするので、ちょっと補足しておきたい。 言いたいことをまともに書こうとするとコメント関連だけでまた1ページ行っちゃいそうなので、とりあえず覚え書きということで＾＾； 以下、主にJavaがターゲット。 コメントが全て全く要らないというわけではない。“適切な”コメントを書くべきだ、という事に異存は無い。 適切な変数名やクラス名・メソッド名を付けるのが大変なのと同様、適切なコメントを書くのは大変。けっこう労力（時間）がかかる。 コメントを書くのは、プログラムをコーディングする能力とは別で、日本語の文章を簡潔に書く能力が必要。 メソッド本体が1行しか無いようなメソッドでもJavadocコメントが数行になったりする事もある。実
Greasemonkey: Javadoc Incremental Search User Script
Updated: 2006-07-09 15:53:00+0900 [Home] This Greasemonkey script adds Incremental Search function to Javadoc 'all classes' frame. Download javadoc_isearch.user.js (2006/07/09 v0.5) Demo Screen Demo (Flash) Features wildcard search (N*P*Exception) Camel Case Search (NPE, NuPoEx) Anchor Search Mode: Press '#' to enter anchor search mode. You can search method and field names from the current select
javadoc をインクリメンタルサーチする - basyura's blog
javadoc を vim から引きたいなぁと試行錯誤していたけれど中断。 本仕様書は著作権により保護されており、本仕様書に記載されている情報は、単数または複数の米国特許、外国特許、または特許出願により保護されている場合があります。以下のライセンスに基づいく場合を除き、Sun Microsystems, Inc. (以下「サン」といいます) および存在する場合はそのライセンサーの書面による事前の許可を得ずに、いかなる方法によっても形式を問わず仕様書のいずれの部分も複製することはできません。 ってあるし。キャッシュ目的で取り込むと複製になるんかな、とかひっかかるし。Sun Microsystems って書いてあるけど Oracle さん怖いし。既存の html を参照するほうが何かと効率が良さそうだし。 ちょっと探してみたら greasemonkey で既にいい感じのがあった。5 年近く前に
JavaDoc出力で「Javadoc この文字は、エンコーディング MS932 にマップできません」エラー
EclipseでそのままコードをJavaDocコンパイルしようとすると、「Javadoc この文字は、エンコーディング MS932 にマップできません」と出てくる。 ギャー！ｗ そん位勝手に変換してくれといいたい。うん。 解決方法は簡単なんで取り合え椅子メモ。 「ファイル」→「エクスポート」→「Java」→「JavaDoc」でたどっていくと最終的に「JavaDocの引数を構成する」ダイアログになるので、 「追加のJavadocオプション」 で -noqualifier all -encoding UTF-8 -docencoding Windows-31J を足してやればいい。 これで他に問題が無ければ無事エクスポートできるはず。
NDoc Online -日本語版-
NDOC は、C# コンパイラ（または VB.NET のためのアドオンのツール）で生成される、 .NET アセンブリと XML ドキュメントからドキュメントを作成する為のツールです。 NDOC はいくつかの形式でドキュメントを作成する為に、Visual Studio .NET にアドオンされている「HTML Help Workshop」などのツールを使用します。 ツールを使用する形式は、MSDN スタイル HTML ヘルプ形式（.chm）、 Visual Studio .NET ヘルプ形式（HTML ヘルプ２）、 および MSDN オンライン スタイルウェブページです。 出力例が見たいのであれば、NDoc のコード中に記述したコメントから NDoc を使用して作成したプログラマリファレンスを参照してください。 ※日本語版ページでは、英語版 NDoc(v1.2) アセンブリと、同 XML フ
サービス提供終了のお知らせ
日頃より、アレスネットをご愛顧いただきまして誠にありがとうございます。 「ホームページサービス」のサービス提供は2016年1月31日をもちまして終了させていただきました。 これまで長らくご利用いただき、誠にありがとうございました。 今後も、皆様によりよいサービスをご提供させていただけるよう、サービス品質向上に努めて参りますので、何卒、ご理解いただけますようお願 い申し上げます。 ＜アレスネットをご契約のお客様へ＞ 後継サービスとして「userwebサービス」を提供させていただいております。 詳しくは、以下のリンクをご参照ください。 ▼「userwebサービス」のご案内 http://www.ejworks.info/userhp/alles/index.html 今後ともアレスネットをご愛顧いただけますようお願い申し上げます。 株式会社イージェーワークス アレスネット カスタマーサポート
javadocでジェネリックメソッドの@linkを書く、他 - 万象酔歩
メモです。 本当はjavadocなどでソースを汚すべきではないのですが、htmlでのオンラインドキュメント を作成するには重宝しますので、使うことはあります。 Javadocは著しくソースの視認性を阻害しますので、ライブラリのオンラインドキュメント を作るといった場合を除いては決して利用すべきではありません。 内部仕様書を書く代わりなどというのはとんでもないことです。 大きなプロジェクトにおいて 決して工数低減にはなりません。この点を管理者は良く認識すべきです。 読んでもらおうとしていない、読んでもらう工夫をしていない javadocなどゴミを散らかしているのと同じです。重要なソース コードをゴミに埋もれさせてはならないのです。 さて、それはともかく本題。 Java8以降の注意点(2020/03/08) @depricatedによる注釈ができなくなった @depricatedを書くと"@d
[Think IT] 第3回：「どのように検証するのか」をJavadocで実現する (1/3)
Javadocはソースコードとドキュメンテーションコメントからリファレンスドキュメントを作成するツールです。ソースコード中のクラス宣言やメソッド宣言と、それらの内容についての説明が書かれたドキュメンテーションコメントを、Javadocが解析してHTML形式のリファレンスドキュメントを作成します。 ソースコードを書く開発者は通常、クラスやメソッドを設計・開発しながら、設計について「なぜそうなっているのか」といった説明や利用の仕方をドキュメンテーションコメントとして残すことができます。つまり、Javadocで作成したリファレンスドキュメントをみれば、クラスやメソッドの設計や利用について、開発者の意図したところが理解できるのです。 しかし、通常のJavadocで作成されたリファレンスドキュメントだけだと、ソースコードをどういう意図で作ったのかはわかりますが、そのソースコードが正しいかということま
[Java]Javadocを印刷したい - 新・たけぞう瀕死の日記
まあ正直Javadocは印刷してどうこうするものではないと思いますが、やんごとなき事情により印刷したいケースというのもあるわけで、そんなときのためのツールとしてPDFDocletというものを教えてもらいました。 http://pdfdoclet.sourceforge.net/ その名の通り、JavadocをPDFとして出力するDocletです。すべてのJavadocが1つのPDFファイルに出力されるので、できたPDFを印刷するだけで済むというシロモノです。 Antで使う場合はこんな感じで。 <javadoc doclet="com.tarsec.javadoc.pdfdoclet.PDFDoclet" docletpath="pdfdoclet-1.0.2-all.jar" classpathref="classpath" additionalparam="-pdf javadoc.pd
![[Java]Javadocを印刷したい - 新・たけぞう瀕死の日記](https://cdn-ak-scissors.b.st-hatena.com/image/square/06a15c64ba0ceec233d86d71001ebb29a9dcbf5d/height=288;version=1;width=512/https%3A%2F%2Fcdn.blog.st-hatena.com%2Fimages%2Ftheme%2Fog-image-1500.png)
エンジニアのためのJavadoc再入門講座 - そうだ？Blogを書こう？
エンジニアのためのJavadoc再入門講座 現場で使えるAPI仕様書の作り方 作者: 佐藤竜一出版社/メーカー: 翔泳社発売日: 2009/06/30メディア: 単行本（ソフトカバー）購入: 15人 クリック: 263回この商品を含むブログ (49件) を見る今までJavadocコメントをしっかり書いたことがなかったので読みました。 すごくためになった！ どうやってJavadocを使うか そもそも生成の仕方とかを知らなかったのですが、その辺から丁寧に説明されていたので個人的によかったです。 ブロックタグを一つ一つ説明していて、どう記述するか、どう表示されるかが丁寧に説明されています。 こういう感じに表示したい！というのがある時に、リファレンスとしても便利そうです。 どういうドキュメントを書くべきか ありがちなメソッド名の日本語訳だけといったコメントをばっさり切り捨て、この箇所はこういうコメ
Javadocメモ(Hishidama's Javadoc Memo)
Javaの特殊なコメント。 コメントの書き方がルール化され、それを元に説明書を作成することが出来る。 クラス・メソッド・フィールド（変数）にJavadocコメント（説明）を付けられるので、それらの説明が見られることになる。 Javadocと言った場合、「Javadocコメントの書き方」と、それを元に生成された「API仕様（HTML文書）」のいずれかを指すことが多い。 後者は、Javaの（標準ライブラリーの）API仕様が有名。→Javadocの読み方（入門者向け） Javadocの生成方法 Javadoc生成用のコマンドを使って、JavaのソースファイルからHTMLを生成する。 javadocコマンド … これが一番基本 Eclipseを使ったJavadoc生成 … お手軽に作りたいなら、これが一番楽 Antのjavadocタスク（javadocタグ） … 何度も自動生成したいなら、これが一
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
JavadocWikiMacro – Trac Hacks - Plugins Macros etc.
http://doc.java.sun.com/DocWeb/