?
快捷搜索:  as  test  1111  test aNd 8=8  test++aNd+8=8  as++aNd+8=8  as aNd 8=8

金沙貴賓官網下載:鏈接span lang=ENUSopopspanBR自定義標記span lang=ENUSopopspanBR設置版本的自動增加span lang=ENUSopopspanBR生成模板span lang=ENUSopopspanBR發布span lang=ENUSJavadocspan到span lang=ENUSGoogel Codespan上span lang=ENUSopopspan

?

媒介

這一段光陰在鉆研Javadoc的問題,前面宣布的Javadoc轉換chm贊助文檔的四種措施總結,總結了若何實現Javadoc到chm的轉金沙貴賓官網下載換,盼望給大年夜家帶來了一些方便,本日我們來說說若何使用Eclipse天生個性化的Javadoc 文檔,也盼望大年夜家支持。

天生對象

Eclipse自帶的導出為Javadoc功能,不應用cmd下的javadoc敕令。

若何個性

會從說話、編碼、鏈接、自定義標記、設置版本的自動增添(并引申Eclipse下若何設置SVN中的svn:keywords屬性)幾個方面來個性你的Javadoc文檔。

個性分化

說話

若何設置天生的Javadoc默認說話?

辦理規劃在Eclipse導出Javadoc后面的設置設置設備金沙貴賓官網下載擺設擺設VM options中加入-locale en_US,然則此時留意的是,假如把-locale en_US設置在后面的話,會報一個差錯,大年夜致是-locale en_US 在javadoc敕令必須是在最前面,默認假如不寫-locale的話,安裝locale說話來進行設置,當然我們中國人便是中文的了。(當然假如你工程默認編碼是GBK而且您想天生中文的贊助文檔的話,這寫都可以不要,應用默認即可)。

編碼

Java代碼編寫的應用有的應用GBK,有的應用UTF-8,這個時刻就會有差別。應用GBK編碼的時刻天生Javadoc文檔時沒有太大年夜問題的,然則,如果全部項目的默認編碼款式是UTF-8的話,就會報警告:編碼 GBK 的弗成映射字符,根本沒有成功天生Javadoc文檔,若何辦理?辦理規劃便是在天生Javadoc的時刻對VM options進行編碼設置-encoding UTF-8 -charset UTF-8。

(詳情請看Javadoc轉換chm贊助文檔的四種措施總結預處置懲罰部分)

鏈接

若何使天生的Javadoc在注釋的時刻有鏈接?大年夜家要知道,天生的Javadoc文檔默認是html款式的,當然可以應用html標記說話來寫一個鏈接,實際上很簡單,看我若何操作。

@author target="_blank">ShunLi

這樣就會天生如下效果

自定義標記

在注釋的時刻,Eclipse中有默認的標記,像@author、@version等,都因此@打頭,現在我們要天生自己的標記。

查看JDK中Javadoc敕令的贊助文檔可以知道(進入cmd敲javadoc –help)

知道必要應用-tag,此中name屬性便是你自定義標記的名稱,locations官方上有以下解釋

Placement of tags - The Xaoptcmf part of the argument determines where in the source code the tag is allowed to be placed, and whether the tag can be disabled (using X). You can supply either a, to allow the tag in all places, or any combination of the other letters:

X (disable tag)

a (all)

o (overview)

p (packages)

t (types, that is classes and interfaces)

c (constructors)

m (methods)

f (fields)

一樣平常我小我覺得都應用,選擇a,header便是在Javadoc中顯示的標題。全部敕令差不多便是這樣的:-tag created:a:"Created:"

* 自定義標記

@notes Created on 2010-1-12

這樣在天生Ja金沙貴賓官網下載vadoc的時刻就不會有報不決義的標記的警告了,然則在天生Javadoc的金沙貴賓官網下載時刻照樣多了一句話:

Note: Custom tags that could override future standard tags:@notes. To avoid potential overrides, use at least one period character (.) in custom tag names.

意思差不多便是你定義的自定義標記有可能會被Sun今后用的,請在定義name的時刻只管即便寫個.號,不用管這句話了。

天生的效果:

上面全部在VM Options你們設置的語句如下:

-locale en_US -encoding UTF-8 -charset UTF-8 -tag notes:a:"Notes:"

設置版本的自動增添

你在做項目的時刻,是不是想應用一個@version的標記,然則我們也不能寫逝世了,不然每次都是@version V1.0什么的,是不是想它能夠根據我們改動文件后能夠自動增添或者賦值。上網搜了很多,沒有一個能實用的,后來照樣在官網上找了一點

@version(reference page)

The Java Software convention for the argument to the @versio金沙貴賓官網下載n tag is the SCCS string "%I%, %G%", which converts to something like "1.39, 02/28/97" (mm/dd/yy) when the file is checked out of SCCS.

意思便是我們要應用SCCS(Source Code Control System),它會跟著SCCS的chedked out增長變更,然則自己沒有深入地打仗SCCS,查了一些資料就放棄走這條道了。后來想想自己應用了SVN,看能不能借用SVN。網上的資料很多,開始繞了很多彎,不知道搜索什么,后來找到,便是設置一下SVN中的svn:keywords屬性。

我一開始在Eclipse中找到了設置屬性的地方,然則有問題,請看:

設置單個文件的屬性,右鍵選擇項目,下圖就有設置屬性

屬性名:輸入svn:keywords,輸入文本屬性為Id Revision Date Author(說一下,曩昔的LastChangedDate、LastChangedBy、LastChangedRevision在SVN1.5里面不在應用,SVN1.5今后應用Date、Revision、Author、HeadURL、Id五個svn:keywords屬性,請參考SVN BOOK和SVN的版本自行改動書寫),下面有個血色的警告:屬性不能利用與文件夾(闡明svn:keywords僅能應用在文件上面),不過不要緊選擇遞歸,打上勾就可以了。

這個對已經提交到辦事器上面的是沒有問題,然則新建的文件就沒有上面的屬性了,不建議大年夜家應用這種措施,這種措施僅適用于必要對單個文件設置屬性。

下面就說一下若何對所有的文件進行設置設置設備擺設擺設,那當然必要對SVN的設置設置設備擺設擺設文件進行設置(不應用TortoiseSVN等辦事器設置設置設備擺設擺設)。

若何的找到svn的config設置設置設備擺設擺設文件?

網上有高手先容如下:

對付Windows xp用戶,每個用戶的config文件一樣平常都能在如下路徑中找到:

C:\Documents and Settings\\Application Data\Subversion\config

免責聲明:以上內容源自網絡,版權歸原作者所有,如有侵犯您的原創版權請告知,我們將盡快刪除相關內容。

您可能還會對下面的文章感興趣:

快三平台开户