summaryrefslogtreecommitdiffstats
path: root/src/site-docs/adoc/fragments/howto-build/documentation.adoc
blob: 3a42cc78b271430dec5262ed8b98850138a7c644 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
//
// ============LICENSE_START=======================================================
//  Copyright (C) 2016-2018 Ericsson. All rights reserved.
// ================================================================================
// This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE
// Full license text at https://creativecommons.org/licenses/by/4.0/legalcode
// 
// SPDX-License-Identifier: CC-BY-4.0
// ============LICENSE_END=========================================================
//
// @author Sven van der Meer (sven.van.der.meer@ericsson.com)
//

== Build the APEX Documentation

The APEX Maven build also includes stand-alone documentations, such as the HowTo documents, the Installation Guide, and the User Manual.
Use Maven to build the APEX Documentation.
The Maven options `-N` prevents Maven to go through all APEX modules, which is not necessary for the documentation.
The final documents will be in `target/generated-docs` (Windows: `target\generated-docs`).
The __HTML__ documents are in the `html/` folder, the __PDF__ documents are in the `pdf/` folder.
Once the documentation is build, copy the __HTML__ and __PDF__ documents to a folder of choice

[width="100%",options="header",cols="5a,5a"]
|====================
| Unix, Cygwin | Windows
|
[source%nowrap,sh,numbered]
----
# cd /usr/local/src/apex
# mvn clean generate-resources -N -DapexDocs
----
|
[source%nowrap,bat,numbered]
----
>c:
>cd \dev\apex
>mvn clean generate-resources -N -DapexDocs
----
|====================