[gradle-1.12] 182/211: Updated man page using Pandoc Markdown

Kai-Chung Yan seamlik-guest at moszumanska.debian.org
Wed Jul 1 14:18:49 UTC 2015


This is an automated email from the git hooks/post-receive script.

seamlik-guest pushed a commit to branch master
in repository gradle-1.12.

commit 0727b68e25a88d2316c8400b1dfb1d9e9780a467
Author: Kai-Chung Yan <seamlikok at gmail.com>
Date:   Wed Jun 17 21:11:18 2015 +0800

    Updated man page using Pandoc Markdown
---
 debian/changelog   |   2 +
 debian/control     |   2 +-
 debian/gradle.1.md | 164 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 debian/gradle.pod  | 137 --------------------------------------------
 debian/rules       |   2 +-
 5 files changed, 168 insertions(+), 139 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 56939de..7e97364 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,8 @@ gradle (1.12+dfsg-1) UNRELEASED; urgency=low
   * New upstream release (Closes: #733148)
   * d/control: Refresh multiple Build-Depends
   * d/control: Add myself as Uploaders (Closes: #683666)
+  * d/bootstrap: Use Gradle 1.5 for bootstrap
+  * d/gradle.1.md: Updated man page for gradle using Pandoc Markdown
   * Remove most symlinks to external jar files
   * Move jars between packages
     - gradle-cli.jar from gradle to libgradle-core-java
diff --git a/debian/control b/debian/control
index 0ad0ebb..5dd7f8a 100644
--- a/debian/control
+++ b/debian/control
@@ -68,7 +68,7 @@ Build-Depends: ant,
                libxerces2-java,
                libxslthl-java,
                maven (>= 3),
-               perl,
+               pandoc,
                quilt,
                testng
 Build-Conflicts: groovy (>= 2.0.0~)
diff --git a/debian/gradle.1.md b/debian/gradle.1.md
new file mode 100644
index 0000000..5425ed7
--- /dev/null
+++ b/debian/gradle.1.md
@@ -0,0 +1,164 @@
+% GRADLE(1) gradle 1.12+dfsg-1 | Gradle Command Line Manual
+% Gradle Depvelopers
+% 2014-04-29
+
+# NAME
+
+gradle - A powerful build system for the JVM
+
+# SYNOPSIS
+
+**gradle** [_option..._] [_task..._]
+
+**./gradlew** [_option..._] [_task..._]
+
+# OPTIONS
+
+## General options
+
+-?, -h, --help
+:   Shows a help message.
+
+-a, --no-rebuild
+:   Do not rebuild project dependencies.
+
+--all
+:   Shows additional detail in the task listing. See Section 11.6.2 of Gradle User Guide, "Listing tasks".
+
+-b, --build-file
+:   Specifies the build file. See Section 11.5 of Gradle User Guide, "Selecting which build to execute".
+
+-c, --settings-file
+:   Specifies the settings file.
+
+--continue
+:   Continues task execution after a task failure.
+
+--configure-on-demand (incubating)
+:   Only relevant projects are configured in this build run. This means faster builds for large multi-projects. See Section 56.1.1.1 of Gradle User Guide, "Configuration on demand".
+
+-D, --system-prop
+:   Sets a system property of the JVM, for example **-Dmyprop=myvalue**. See Section 14.2 of Gradle User Guide, "Gradle properties and system properties".
+
+-d, --debug
+:   Log in debug mode (includes normal stacktrace). See Chapter 18 of Gradle User Guide, "Logging".
+
+-g, --gradle-user-home
+:   Specifies the Gradle user home directory. The default is the **.gradle** directory in the user's home directory.
+
+--gui
+:   Launches the Gradle GUI. See Chapter 12 of Gradle User Guide, "Using the Gradle Graphical User Interface".
+
+-I, --init-script
+:   Specifies an initialization script. See Chapter 60 of Gradle User Guide, "Initialization Scripts".
+
+-i, --info
+:   Set log level to info. See Chapter 18 of Gradle User Guide, "Logging".
+
+-m, --dry-run
+:   Runs the build with all task actions disabled. See Section 11.7 of Gradle User Guide, "Dry Run".
+
+--no-color
+:   Do not use color in the console output.
+
+--offline
+:   Specifies that the build should operate without accessing network resources. See Section 50.9.2 of Gradle User Guide, "Command line options to override caching".
+
+-P, --project-prop
+:   Sets a project property of the root project, for example **-Pmyprop=myvalue**. See Section 14.2 of Gradle User Guide, "Gradle properties and system properties".
+
+-p, --project-dir
+:   Specifies the start directory for Gradle. Defaults to current directory. See Section 11.5 of Gradle User Guide, "Selecting which build to execute".
+
+--parallel (incubating)
+:   Build projects in parallel. Gradle will attempt to determine the optimal number of executor threads to use. This option should only be used with decoupled projects (see Section 56.9 of Gradle User Guide, "Decoupled Projects").
+
+--parallel-threads (incubating)
+:   Build projects in parallel, using the specified number of executor threads. For example **--parallel-threads=3**. This option should only be used with decoupled projects (see Section 56.9 of Gradle User Guide, "Decoupled Projects").
+
+--profile
+:   Profiles build execution time and generates a report in the **buildDir/reports/profile** directory. See Section 11.6.7 of Gradle User Guide, "Profiling a build".
+
+--project-cache-dir
+:   Specifies the project-specific cache directory. Default value is **.gradle** in the root project directory. See Section 14.6 of Gradle User Guide, "Caching".
+
+-q, --quiet
+:   Log errors only. See Chapter 18 of Gradle User Guide, "Logging".
+
+--recompile-scripts
+:   Specifies that cached build scripts are skipped and forced to be recompiled. See Section 14.6 of Gradle User Guide, "Caching".
+
+--refresh-dependencies
+:   Refresh the state of dependencies. See Section 50.9.2 of Gradle User Guide, "Command line options to override caching".
+
+--rerun-tasks
+:   Specifies that any task optimization is ignored.
+
+-S, --full-stacktrace
+:   Print out the full (very verbose) stacktrace for any exceptions. See Chapter 18 of Gradle User Guide, "Logging".
+
+-s, --stacktrace
+:   Print out the stacktrace also for user exceptions (e.g. compile error). See Chapter 18 of Gradle User Guide, "Logging".
+
+-u, --no-search-upwards
+:   Don't search in parent directories for a **settings.gradle** file.
+
+-v, --version
+:   Prints version info.
+
+-x, --exclude-task
+:   Specifies a task to be excluded from execution. See Section 11.2 of Gradle User Guide, "Excluding tasks".
+
+The above information is printed to the console when you execute **gradle -h**.
+
+## Deprecated options
+
+The following options are deprecated and will be removed in a future version of Gradle:
+
+-C, --cache
+:   (deprecated) Specifies how compiled build scripts should be cached. Possible values are: **rebuild** or **on**. Default value is **on**. You should use **--recompile-scripts** instead.
+
+--no-opt
+:   (deprecated) Specifies to ignore all task optimization. You should use **--rerun-tasks** instead.
+
+--refresh
+:   (deprecated) Refresh the state of resources of the type(s) specified. Currently only dependencies is supported. You should use **--refresh-dependencies** instead.
+
+## Daemon options
+
+The Chapter 19 of Gradle User Guide, "The Gradle Daemon" contains more information about the daemon. For example it includes information how to turn on the daemon by default so that you can avoid using **--daemon** all the time.
+
+--daemon
+:   Uses the Gradle daemon to run the build. Starts the daemon if not running or existing daemon busy. Chapter 19 of Gradle User Guide, "The Gradle Daemon" contains more detailed information when new daemon processes are started.
+
+--foreground
+:   Starts the Gradle daemon in the foreground. Useful for debugging or troubleshooting because you can easily monitor the build execution.
+
+--no-daemon
+:   Do not use the Gradle daemon to run the build. Useful occasionally if you have configured Gradle to always run with the daemon by default.
+
+--stop
+:   Stops the Gradle daemon if it is running. You can only stop daemons that were started with the Gradle version you use when running **--stop**.
+
+# SYSTEM PROPERTIES
+
+The following system properties are available for the **gradle** command. Note that command-line options take precedence over system properties.
+
+gradle.user.home
+:   Specifies the Gradle user home directory.
+
+The Section 20.1 of Gradle User Guide, “Configuring the build environment via gradle.properties” contains specific information about Gradle configuration available via system properties.
+
+# ENVIRONMENT
+
+The following environment variables are available for the **gradle** command. Note that command-line options and system properties take precedence over environment variables.
+
+GRADLE_OPTS
+:   Specifies command-line arguments to use to start the JVM. This can be useful for setting the system properties to use for running Gradle. For example you could set **GRADLE_OPTS="-Dorg.gradle.daemon=true"** to use the Gradle daemon without needing to use the **--daemon** option every time you run Gradle. Section 20.1 of Gradle User Guide, “Configuring the build environment via gradle.properties” contains more information about ways of configuring the daemon without using environmenta [...]
+
+GRADLE_USER_HOME
+: Specifies the Gradle user home directory.
+
+# SEE ALSO
+
+/usr/share/doc/gradle/userguide/userguide.html
\ No newline at end of file
diff --git a/debian/gradle.pod b/debian/gradle.pod
deleted file mode 100644
index 44b387f..0000000
--- a/debian/gradle.pod
+++ /dev/null
@@ -1,137 +0,0 @@
-=head1 NAME
-
-gradle - Groovy based build system
-
-=head1 SYNOPSIS
-
-gradle <target> [options]
-
-=head1 OVERVIEW
-
-Gradle is a build system written in Groovy. It uses Groovy
-also as the language for its build scripts. It has a powerful
-multi-project build support. It has a layer on top of Ivy
-that provides a build-by-convention integration for Ivy. It
-gives you always the choice between the flexibility of Ant
-and the convenience of a build-by-convention behavior.
-
-For additional information, see http://gradle.org/documentation.html.
-
-=head1 OPTIONS
-
-=over 4
-
-=item B<-?>, B<-h>, B<--help>
-
-Shows the help message.
-
-=item B<-A> I<task>[,...], B<--dep-tasks> I<task>[,...]
-
-Specify additional tasks for building project dependencies.
-
-=item B<-C> I<value>, B<--cache> I<value>
-
-Specifies how compiled build scripts should be cached. Possible values
-are: 'rebuild' and 'on'. Default value is 'on'.
-
-=item B<-D>I<propertie=value>, B<--system-prop> I<propertie=value>
-
-Set system property of the JVM (e.g. -Dmyprop=myvalue).
-
-=item B<-I> I<script>, B<--init-script> I<script>
-
-Specifies an initialization script.
-
-=item B<-P>I<propertie=value>, B<--project-prop> I<propertie=value>
-
-Set project property for the build script (e.g. -Pmyprop=myvalue).
-
-=item B<-S>, B<--full-stacktrace>
-
-Print out the full (very verbose) stacktrace for any exceptions.
-
-=item B<-a>, B<--no-rebuild>
-
-Do not rebuild project dependencies.
-
-=item B<--all>
-
-Show additional details in the task listing.
-
-=item B<-b> I<file>, B<--build-file> I<file>
-
-Specifies the build file.
-
-=item B<-c> I<file>, B<--settings-file> I<file>
-
-Specifies the settings file.
-
-=item B<-d>, B<--debug>
-
-Log in debug mode (includes normal stacktrace).                         
-
-=item B<-e> I<file>, B<--embedded> I<file>
-
-Specify an embedded build script.
-
-=item B<-g> I<directory>, B<--gradle-user-home> I<directory>
-
-Specifies the gradle user home directory.
-
-=item B<--gui>
-
-Launches a GUI application
-
-=item B<-i> I<value>, B<--info> I<value>
-
-Set log level to info.
-
-=item B<-m>, B<--dry-run>
-
-Runs the builds with all task actions disabled.
-
-=item B<-n>, B<--dependencies>
-
-Show list of all project dependencies.
-
-=item B<--no-opt>
-
-Ignore any task optimization.
-
-=item B<-p> I<directory>, B<--project-dir> I<directory>
-
-Specifies the start directory for Gradle. Defaults to current directory.
-
-=item B<-q>, B<--quiet>
-
-Log errors only.
-
-=item B<-r>, B<--properties>
-
-Show list of all available project properties.
-
-=item B<-s>, B<--stacktrace>
-
-Print out the stacktrace also for user exceptions (e.g. compile error).
-
-=item B<-t>, B<--tasks>
-
-Show list of all available tasks.
-
-=item B<-u>, B<--no-search-upward>
-
-Don't search in parent folders for a settings.gradle file.
-
-=item B<-v>, B<--version>
-
-Print version info.
-
-=item B<-x> I<task>, B<--exclude-task> I<task>
-
-Specify a task to be excluded from execution.
-
-=back
-
-=head1 SEE ALSO
-
-http://gradle.org/userguide.html
diff --git a/debian/rules b/debian/rules
index c16176d..9818b66 100755
--- a/debian/rules
+++ b/debian/rules
@@ -26,7 +26,7 @@ override_dh_auto_build:
 	cp -r subprojects/base-services/src/main/java/ buildSrc/src/main/
 
 	gradle $(GRADLE_TASKS) $(GRADLE_FLAGS)
-	pod2man -c '' -r '' debian/gradle.pod > debian/gradle.1
+	pandoc -s -o debian/gradle.1 debian/gradle.1.md
 
 	rm -rf .gradle/ .gradlehome/ buildSrc/.gradle/ buildSrc/build/
 	rm -rf buildSrc/src/main/java/

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-java/gradle-1.12.git



More information about the pkg-java-commits mailing list