From 724da52635fbcc7c80cd0b7932f8b0d1cff6cb73 Mon Sep 17 00:00:00 2001 From: James Moger Date: Wed, 19 Jun 2013 20:56:07 -0400 Subject: Documentation --- build.xml | 8 ++++++-- releases.moxie | 15 ++++++++------- src/site/features.mkd | 12 +++++++----- src/site/roadmap.mkd | 5 +---- src/site/setup.mkd | 6 +++--- 5 files changed, 25 insertions(+), 21 deletions(-) diff --git a/build.xml b/build.xml index 39f39ebd..894e51a4 100644 --- a/build.xml +++ b/build.xml @@ -298,6 +298,7 @@ + @@ -412,6 +413,7 @@ + @@ -701,7 +703,8 @@ - + + @@ -917,7 +920,8 @@ - + + diff --git a/releases.moxie b/releases.moxie index c68ef199..4d2e8752 100644 --- a/releases.moxie +++ b/releases.moxie @@ -51,10 +51,10 @@ r17: { - Added simple star/unstar function to flag or bookmark interesting repositories - Added Dashboard page which shows a news feed for starred repositories and offers a filterable list of repositories you care about - Added a ui for the push log introduced in 1.2.1 (issue-177) - - Added client application menus for Git, SourceTree, Tower, GitHub for Windows, GitHub for Mac, and SparkleShare + - Added client application menus for Git, SmartGit/Hg, SourceTree, Tower, GitHub for Windows, GitHub for Mac, and SparkleShare - Added GO http/https connector thread pool size setting - Added a server setting to force a particular translation/Locale for all sessions - - Added smart Git Daemon serving. If enabled, git:// access will be offered for any repository which permits anonymous access. If the repository permits anonymous cloning, anonymous git:// clone will be permitted while anonmymous git:// pushes will be rejected. + - Added smart Git Daemon serving. If enabled, git:// access will be offered for any repository which permits anonymous access. If the repository permits anonymous cloning, anonymous git:// clone will be permitted while anonmymous git:// pushes will be rejected. - Option to automatically tag branch tips on each push with an incremental revision number - Implemented multiple repository owners - Optional periodic LDAP user and team pre-fetching & synchronization @@ -99,24 +99,25 @@ r17: { - Thomas Pummer - William Whittle - Yukihiko Sawanobori - - github/akquinet - - github/dapengme + - github/akquinet + - github/dapengme dependencyChanges: - JGit 3.0.0-SNAPSHOT - Iconic font - AngularJS 1.0.7 + - FreeMarker 2.3.19 settings: - { name: 'git.daemonBindInterface', defaultValue: 'localhost' } - { name: 'git.daemonPort', defaultValue: 0 } - - { name: 'git.defaultIncrementalPushTagPrefix', defaultValue: 'r' } - - { name: 'mail.smtps', defaultValue: false } + - { name: 'git.defaultIncrementalPushTagPrefix', defaultValue: 'r' } + - { name: 'mail.smtps', defaultValue: 'false' } - { name: 'realm.container.autoCreateAccounts', defaultValue: 'false' } - { name: 'realm.salesforce.backingUserService', defaultValue: 'users.conf' } - { name: 'realm.salesforce.orgId', defaultValue: 0 } - { name: 'web.activityDurationChoices', defaultValue: '7 14 28 60 90 180' } - - { name: 'web.allowAppCloneLinks', defaultValue: true } + - { name: 'web.allowAppCloneLinks', defaultValue: 'true' } - { name: 'web.forceDefaultLocale', defaultValue: ' ' } - { name: 'web.metricAuthorExclusions', defaultValue: ' ' } - { name: 'web.overviewPushCount', defaultValue: 5 } diff --git a/src/site/features.mkd b/src/site/features.mkd index 9751482f..fd89ad87 100644 --- a/src/site/features.mkd +++ b/src/site/features.mkd @@ -1,6 +1,7 @@ ## Standard Features (GO/WAR) - JGit http/https SmartHTTP servlet - JGit git protocol daemon +- Menu driven native platform clone links for all popular Git clients - Browser and git client authentication - Four *per-repository* access restriction configurations with a Read-Only control flag - ![anonymous](blank.png) *Anonymous View, Clone & Push* @@ -34,10 +35,11 @@ - Administrators and Repository Owners may set the default branch through the web UI or RPC interface - LDAP authentication and optional LDAP-controlled Team memberships - Redmine authentication +- Salesforce.com authentication - Gravatar integration - Git-notes display support - Submodule support -- Push log based on a hidden, orphan branch refs/gitblit/pushes +- User-tracked reflog for pushes, tags, etc. - Fanout PubSub notifications service for self-hosted [Sparkleshare](http://sparkleshare.org) use - gh-pages display support (Jekyll is not supported) - Branch metrics (uses Google Charts) @@ -53,16 +55,16 @@ - Single text file for users configuration - Optional utility pages - ![docs](book_16x16.png) Docs page which enumerates all Markdown files within a repository - - ![tickets](bug_16x16.png) **readonly** Ticgit ticket pages *(based on last MIT release bf57b032 2009-01-27)* + - ![tickets](bug_16x16.png) **readonly and deprecated** Ticgit ticket pages *(based on last MIT release bf57b032 2009-01-27)* - Translations - English - Japanese - Spanish - Polish - Korean - - Brazilian Portuguese - - Dutch - - Chinese (zh_CN) + - Brazilian Portuguese + - Dutch + - Chinese (zh_CN) ## Gitblit GO Features - Out-of-the-box integrated stack requiring minimal configuration diff --git a/src/site/roadmap.mkd b/src/site/roadmap.mkd index 4ac9b478..509c6b20 100644 --- a/src/site/roadmap.mkd +++ b/src/site/roadmap.mkd @@ -8,7 +8,6 @@ This list is volatile. * Eclipse: create plugin to enumerate repositories and delegate cloning to EGit * Manager: support federation RPCs * Manager: redesign ref indicators in log, search, and activity views to support multiple local branches, remote branches, and tags -* Gitblit: Serve repositories on root URL rather than /git (investigate JGit 1.2 GitFilter) ### TODO (medium priority) @@ -21,9 +20,7 @@ This list is volatile. ### IDEAS -* Gitblit: Pull requests -* Gitblit: Watch/Star like github with personalized activity feed -* Gitblit: Push database or orphan branch +* Gitblit: GitHub-style Pull Requests or Gerrit-style Patchsets * Gitblit: Re-use the EGit branch visualization table cell renderer as some sort of servlet * Gitblit: diff should highlight inserted/removed fragment compared to original line * Gitblit: respect Gerrit branch permissions diff --git a/src/site/setup.mkd b/src/site/setup.mkd index 525be855..1a300228 100644 --- a/src/site/setup.mkd +++ b/src/site/setup.mkd @@ -49,7 +49,7 @@ If you are deploying Gitblit to a *nix platform, you might consider moving the d ### Creating your own Self-Signed SSL Certificate Gitblit GO (and Gitblit Certificate Authority) automatically generates a Certificate Authority (CA) certificate and an ssl certificate signed by this CA certificate that is bound to *localhost*. -Remote Eclipse/EGit/JGit clients (<= 2.2.0) will fail to communicate using this certificate because JGit always verifies the hostname of the certificate, regardless of the *http.sslVerify=false* client-side setting. +Remote Eclipse/EGit/JGit clients (< 3.0) will fail to communicate using this certificate because JGit always verifies the hostname of the certificate, regardless of the *http.sslVerify=false* client-side setting. The EGit failure message is something like: @@ -365,7 +365,7 @@ The preceding example should suggest that order of permissions is important with 2. Else if a team has an explicit permission, use that 3. Else check for the first regex match in team permissions -#### No-So-Discrete Permissions (Gitblit <= v1.1.0) +#### No-So-Discrete Permissions (Gitblit <= v1.1.0) Prior to v1.2.0, Gitblit has two main access permission groupings: @@ -741,7 +741,7 @@ You must tell Git/JGit not to verify the self-signed certificate in order to per **NOTE:** The default self-signed certificate generated by Gitlbit GO is bound to *localhost*. If you are using Eclipse/EGit/JGit clients, you will have to generate your own certificate that specifies the exact hostname used in your clone/push url. -You must do this because Eclipse/EGit/JGit (<= 2.3.1) always verifies certificate hostnames, regardless of the *http.sslVerify=false* client-side setting. +You must do this because Eclipse/EGit/JGit (< 3.0) always verifies certificate hostnames, regardless of the *http.sslVerify=false* client-side setting. - **Eclipse/EGit/JGit** 1. Window->Preferences->Team->Git->Configuration -- cgit v1.2.3