diff options
author | Kristian Aune <kraune@yahoo-inc.com> | 2017-01-19 09:54:44 +0100 |
---|---|---|
committer | Kristian Aune <kraune@yahoo-inc.com> | 2017-01-19 09:54:44 +0100 |
commit | 7ea0098e67968aaf697bc28acc89f27aa373d25c (patch) | |
tree | 7166b00ce5b558ba243e5fd29b5a8bd204a25095 /config-class-plugin/README.md | |
parent | 127dfb980e0537df49cbe3d6fec22886e2a44924 (diff) |
use .md as all other files
Diffstat (limited to 'config-class-plugin/README.md')
-rw-r--r-- | config-class-plugin/README.md | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/config-class-plugin/README.md b/config-class-plugin/README.md new file mode 100644 index 00000000000..5fa87da63e1 --- /dev/null +++ b/config-class-plugin/README.md @@ -0,0 +1,60 @@ +Vespa Config Generation +======================= + +The vespa-configgen plugin is used to generate config-classes from .def files. + +Userguide +--------- +Put your .def files in `src/main/vespa-configdef` + +Depend on this plugin in your `pom.xml` + + <dependencies> + <dependency> + <groupId>com.yahoo.vespa</groupId> + <artifactId>vespa-configgen-plugin</artifactId> + <version>1.0-SNAPSHOT</version> + </dependency> + </dependencies> + +Add the following to the 'build' section of your `pom.xml` + + <build> + <plugins> + <plugin> + <groupId>com.yahoo.vespa</groupId> + <artifactId>vespa-configgen-plugin</artifactId> + <executions> + <execution> + <id>config-gen</id> + <goals> + <goal>config-gen</goal> + </goals> + </execution> + </executions> + </plugin> + </plugins> + </build> + +The .def files will now be processed during the generate-sources step, and produce output +in the `target/generated-sources/vespa-configgen-plugin` directory. This directory +is automatically added to the source path of your project. + +It is possible to configure the location(s) of def-files, and the output of the generated sources. +Put the following configuration under the plugin in the build section: + + <build> + <plugins> + <plugin> + <groupId>com.yahoo.vespa</groupId> + <artifactId>vespa-configgen-plugin</artifactId> + <configuration> + <defFilesDirectories>etc, src/main/def-files</defFilesDirectories> + <outputDirectory>target/generated-sources/vespa-configgen-plugin</outputDirectory> + </configuration> + </plugin> + </plugins> + </build> + +To run only the config-gen goal from the command-line: +$ mvn com.yahoo.vespa:vespa-configgen-plugin:config-gen |