machinery-tool 1.21.0 → 1.22.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (85) hide show
  1. checksums.yaml +4 -4
  2. data/.git_revision +1 -1
  3. data/NEWS +8 -0
  4. data/html/index.html.haml +8 -7
  5. data/html/partials/changed_config_files.html.haml +1 -1
  6. data/html/partials/changed_managed_files.html.haml +1 -1
  7. data/html/partials/unmanaged_files.html.haml +2 -2
  8. data/lib/cli.rb +26 -4
  9. data/lib/diff_widget.rb +73 -0
  10. data/lib/dpkg_database.rb +16 -1
  11. data/lib/haml_helpers.rb +60 -0
  12. data/lib/kiwi_config.rb +7 -0
  13. data/lib/machinery.rb +3 -0
  14. data/lib/man_task.rb +3 -2
  15. data/lib/move_task.rb +1 -0
  16. data/lib/remote_system.rb +4 -0
  17. data/lib/server.rb +2 -105
  18. data/lib/static_html.rb +75 -0
  19. data/lib/system.rb +2 -1
  20. data/lib/system_description.rb +10 -0
  21. data/lib/version.rb +1 -1
  22. data/machinery-helper/version.go +1 -1
  23. data/man/generated/machinery.1.gz +0 -0
  24. data/manual/docs/README.md +8 -16
  25. data/manual/docs/docs.md +42 -4
  26. data/manual/docs/index.html +6 -2
  27. data/manual/docs/machinery-analyze.1.md +6 -10
  28. data/manual/docs/machinery-build.1.md +7 -11
  29. data/manual/docs/machinery-compare.1.md +5 -10
  30. data/manual/docs/machinery-config.1.md +4 -7
  31. data/manual/docs/machinery-copy.1.md +5 -10
  32. data/manual/docs/machinery-deploy.1.md +8 -12
  33. data/manual/docs/machinery-export-autoyast.1.md +10 -17
  34. data/manual/docs/machinery-export-html.1.md +32 -0
  35. data/manual/docs/machinery-export-kiwi.1.md +7 -12
  36. data/manual/docs/{machinery-inspect-docker.1.md → machinery-inspect-container.1.md} +10 -15
  37. data/manual/docs/machinery-inspect.1.md +10 -15
  38. data/manual/docs/machinery-list.1.md +4 -8
  39. data/manual/docs/machinery-man.1.md +4 -6
  40. data/manual/docs/machinery-move.1.md +4 -8
  41. data/manual/docs/machinery-remove.1.md +5 -10
  42. data/manual/docs/machinery-serve.1.md +5 -9
  43. data/manual/docs/machinery-show.1.md +7 -11
  44. data/manual/docs/machinery-upgrade-format.1.md +5 -9
  45. data/manual/docs/machinery-validate.1.md +4 -8
  46. data/manual/docs/machinery_main_general.1.md +33 -51
  47. data/manual/docs/machinery_main_scopes.1.md +13 -14
  48. data/manual/docs/{machinery_security_implications.1.md → machinery_main_security_implications.1.md} +15 -15
  49. data/manual/docs/machinery_main_usecases.1.md +2 -30
  50. data/manual/mkdocs.yml +9 -9
  51. data/manual/site/docs/index.html +71 -25
  52. data/manual/site/index.html +6 -2
  53. data/manual/site/machinery-analyze.1/index.html +34 -27
  54. data/manual/site/machinery-build.1/index.html +35 -28
  55. data/manual/site/machinery-compare.1/index.html +33 -26
  56. data/manual/site/machinery-config.1/index.html +32 -25
  57. data/manual/site/machinery-copy.1/index.html +33 -27
  58. data/manual/site/machinery-deploy.1/index.html +36 -29
  59. data/manual/site/machinery-export-autoyast.1/index.html +38 -32
  60. data/manual/site/machinery-export-html.1/index.html +175 -0
  61. data/manual/site/machinery-export-kiwi.1/index.html +35 -28
  62. data/manual/site/machinery-inspect-container.1/index.html +249 -0
  63. data/manual/site/machinery-inspect.1/index.html +38 -31
  64. data/manual/site/machinery-list.1/index.html +32 -25
  65. data/manual/site/machinery-man.1/index.html +32 -26
  66. data/manual/site/machinery-move.1/index.html +32 -25
  67. data/manual/site/machinery-remove.1/index.html +33 -26
  68. data/manual/site/machinery-serve.1/index.html +33 -26
  69. data/manual/site/machinery-show.1/index.html +35 -28
  70. data/manual/site/machinery-upgrade-format.1/index.html +33 -26
  71. data/manual/site/machinery-validate.1/index.html +32 -25
  72. data/manual/site/machinery_main_general.1/index.html +63 -70
  73. data/manual/site/machinery_main_scopes.1/index.html +41 -36
  74. data/manual/site/machinery_main_security_implications.1/index.html +228 -0
  75. data/manual/site/machinery_main_usecases.1/index.html +30 -48
  76. data/manual/site/mkdocs/search_index.json +246 -201
  77. data/manual/site/sitemap.xml +40 -30
  78. data/plugins/os/os_inspector.rb +1 -1
  79. data/plugins/packages/packages.yml +1 -1
  80. data/plugins/patterns/patterns.yml +2 -5
  81. data/plugins/repositories/repositories.yml +2 -2
  82. data/plugins/unmanaged_files/unmanaged_files.yml +3 -3
  83. data/plugins/unmanaged_files/unmanaged_files_renderer.rb +1 -1
  84. metadata +11 -5
  85. data/manual/docs/subcommand-template.1.md +0 -46
data/manual/site/machinery-compare.1/index.html CHANGED
@@ -23,26 +23,29 @@
23
23
 
24
24
 
25
25
 
26
- <li>Home
27
- <ul>
28
-
29
- <li class="">
30
- <a href="../machinery_main_general.1/">General</a>
31
- </li>
32
-
33
- <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
35
- </li>
36
-
37
- <li class="">
38
- <a href="../machinery_main_usecases.1/">Use cases</a>
39
- </li>
40
-
41
- <li class="">
42
- <a href="../machinery_security_implications.1/">Security Implications</a>
43
- </li>
44
-
45
- </ul>
26
+ <li class="">
27
+ <a href="../machinery_main_general.1/">General Overview</a>
28
+ </li>
29
+
30
+
31
+
32
+
33
+ <li class="">
34
+ <a href="../machinery_main_scopes.1/">Scopes</a>
35
+ </li>
36
+
37
+
38
+
39
+
40
+ <li class="">
41
+ <a href="../machinery_main_usecases.1/">Use cases</a>
42
+ </li>
43
+
44
+
45
+
46
+
47
+ <li class="">
48
+ <a href="../machinery_main_security_implications.1/">Security Implications</a>
46
49
  </li>
47
50
 
48
51
 
@@ -83,12 +86,16 @@
83
86
  <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
84
87
  </li>
85
88
 
89
+ <li class="">
90
+ <a href="../machinery-export-html.1/">Export HTML</a>
91
+ </li>
92
+
86
93
  <li class="">
87
94
  <a href="../machinery-inspect.1/">Inspect</a>
88
95
  </li>
89
96
 
90
97
  <li class="">
91
- <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
98
+ <a href="../machinery-inspect-container.1/">Inspect Container</a>
92
99
  </li>
93
100
 
94
101
  <li class="">
@@ -132,13 +139,13 @@
132
139
  </div>
133
140
  <div class="content">
134
141
  <h1 id="compare-compare-system-descriptions">compare — Compare System Descriptions</h1>
135
- <h2 id="synopsis">SYNOPSIS</h2>
142
+ <h2 id="synopsis">Synopsis</h2>
136
143
  <p><code>machinery compare</code> [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-all] [--html] NAME1 NAME2</p>
137
144
  <p><code>machinery</code> help compare</p>
138
- <h2 id="description">DESCRIPTION</h2>
145
+ <h2 id="description">Description</h2>
139
146
  <p>The <code>compare</code> command compares stored system descriptions. The scope option can
140
147
  be used to limit the output to the given scopes.</p>
141
- <h2 id="arguments">ARGUMENTS</h2>
148
+ <h2 id="arguments">Arguments</h2>
142
149
  <ul>
143
150
  <li>
144
151
  <p><code>NAME1</code> (required):
@@ -149,7 +156,7 @@ be used to limit the output to the given scopes.</p>
149
156
  Second system description to compare.</p>
150
157
  </li>
151
158
  </ul>
152
- <h2 id="options">OPTIONS</h2>
159
+ <h2 id="options">Options</h2>
153
160
  <ul>
154
161
  <li>
155
162
  <p><code>-s SCOPE</code>, <code>--scope=SCOPE</code> (optional):
@@ -174,7 +181,7 @@ be used to limit the output to the given scopes.</p>
174
181
  Shows the comparison of two system descriptions in the web browser.</p>
175
182
  </li>
176
183
  </ul>
177
- <h2 id="examples">EXAMPLES</h2>
184
+ <h2 id="examples">Examples</h2>
178
185
  <ul>
179
186
  <li>
180
187
  <p>Compare system descriptions saved as <code>earth</code> and <code>moon</code>:</p>
data/manual/site/machinery-config.1/index.html CHANGED
@@ -23,26 +23,29 @@
23
23
 
24
24
 
25
25
 
26
- <li>Home
27
- <ul>
28
-
29
- <li class="">
30
- <a href="../machinery_main_general.1/">General</a>
31
- </li>
32
-
33
- <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
35
- </li>
36
-
37
- <li class="">
38
- <a href="../machinery_main_usecases.1/">Use cases</a>
39
- </li>
40
-
41
- <li class="">
42
- <a href="../machinery_security_implications.1/">Security Implications</a>
43
- </li>
44
-
45
- </ul>
26
+ <li class="">
27
+ <a href="../machinery_main_general.1/">General Overview</a>
28
+ </li>
29
+
30
+
31
+
32
+
33
+ <li class="">
34
+ <a href="../machinery_main_scopes.1/">Scopes</a>
35
+ </li>
36
+
37
+
38
+
39
+
40
+ <li class="">
41
+ <a href="../machinery_main_usecases.1/">Use cases</a>
42
+ </li>
43
+
44
+
45
+
46
+
47
+ <li class="">
48
+ <a href="../machinery_main_security_implications.1/">Security Implications</a>
46
49
  </li>
47
50
 
48
51
 
@@ -83,12 +86,16 @@
83
86
  <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
84
87
  </li>
85
88
 
89
+ <li class="">
90
+ <a href="../machinery-export-html.1/">Export HTML</a>
91
+ </li>
92
+
86
93
  <li class="">
87
94
  <a href="../machinery-inspect.1/">Inspect</a>
88
95
  </li>
89
96
 
90
97
  <li class="">
91
- <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
98
+ <a href="../machinery-inspect-container.1/">Inspect Container</a>
92
99
  </li>
93
100
 
94
101
  <li class="">
@@ -132,18 +139,18 @@
132
139
  </div>
133
140
  <div class="content">
134
141
  <h1 id="config-configure-machinery">config — Configure Machinery</h1>
135
- <h2 id="synopsis">SYNOPSIS</h2>
142
+ <h2 id="synopsis">Synopsis</h2>
136
143
  <p><code>machinery config</code></p>
137
144
  <p><code>machinery config</code> KEY</p>
138
145
  <p><code>machinery config</code> KEY=VALUE</p>
139
146
  <p><code>machinery</code> help config</p>
140
- <h2 id="description">DESCRIPTION</h2>
147
+ <h2 id="description">Description</h2>
141
148
  <p>The <code>config</code> command shows or changes machinery's configuration.</p>
142
149
  <p>If no arguments are passed the <code>config</code> command lists all configuration
143
150
  entries and their values. If only the key is provided its value is shown.
144
151
  If key and value are specified this configuration entry is set accordingly.</p>
145
152
  <p>The configuration is stored in <code>~/.machinery/machinery.config</code>.</p>
146
- <h2 id="arguments">ARGUMENTS</h2>
153
+ <h2 id="arguments">Arguments</h2>
147
154
  <ul>
148
155
  <li>
149
156
  <p><code>KEY</code>:
@@ -154,7 +161,7 @@ If key and value are specified this configuration entry is set accordingly.</p>
154
161
  Value of the configuration entry.</p>
155
162
  </li>
156
163
  </ul>
157
- <h2 id="examples">EXAMPLES</h2>
164
+ <h2 id="examples">Examples</h2>
158
165
  <ul>
159
166
  <li>
160
167
  <p>Turn off hints:</p>
data/manual/site/machinery-copy.1/index.html CHANGED
@@ -23,26 +23,29 @@
23
23
 
24
24
 
25
25
 
26
- <li>Home
27
- <ul>
28
-
29
- <li class="">
30
- <a href="../machinery_main_general.1/">General</a>
31
- </li>
32
-
33
- <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
35
- </li>
36
-
37
- <li class="">
38
- <a href="../machinery_main_usecases.1/">Use cases</a>
39
- </li>
40
-
41
- <li class="">
42
- <a href="../machinery_security_implications.1/">Security Implications</a>
43
- </li>
44
-
45
- </ul>
26
+ <li class="">
27
+ <a href="../machinery_main_general.1/">General Overview</a>
28
+ </li>
29
+
30
+
31
+
32
+
33
+ <li class="">
34
+ <a href="../machinery_main_scopes.1/">Scopes</a>
35
+ </li>
36
+
37
+
38
+
39
+
40
+ <li class="">
41
+ <a href="../machinery_main_usecases.1/">Use cases</a>
42
+ </li>
43
+
44
+
45
+
46
+
47
+ <li class="">
48
+ <a href="../machinery_main_security_implications.1/">Security Implications</a>
46
49
  </li>
47
50
 
48
51
 
@@ -83,12 +86,16 @@
83
86
  <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
84
87
  </li>
85
88
 
89
+ <li class="">
90
+ <a href="../machinery-export-html.1/">Export HTML</a>
91
+ </li>
92
+
86
93
  <li class="">
87
94
  <a href="../machinery-inspect.1/">Inspect</a>
88
95
  </li>
89
96
 
90
97
  <li class="">
91
- <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
98
+ <a href="../machinery-inspect-container.1/">Inspect Container</a>
92
99
  </li>
93
100
 
94
101
  <li class="">
@@ -132,15 +139,14 @@
132
139
  </div>
133
140
  <div class="content">
134
141
  <h1 id="copy-copy-system-description">copy — Copy System Description</h1>
135
- <h2 id="synopsis">SYNOPSIS</h2>
136
- <p><code>machinery copy</code>
137
- FROM_NAME TO_NAME</p>
142
+ <h2 id="synopsis">Synopsis</h2>
143
+ <p><code>machinery copy</code> FROM_NAME TO_NAME</p>
138
144
  <p><code>machinery</code> help copy</p>
139
- <h2 id="description">DESCRIPTION</h2>
145
+ <h2 id="description">Description</h2>
140
146
  <p>The <code>copy</code> command copies a stored system description. It creates a new
141
147
  description named TO_NAME containing the same content as the description
142
148
  FROM_NAME.</p>
143
- <h2 id="arguments">ARGUMENTS</h2>
149
+ <h2 id="arguments">Arguments</h2>
144
150
  <ul>
145
151
  <li>
146
152
  <p><code>FROM_NAME</code> (required):
@@ -151,7 +157,7 @@ FROM_NAME.</p>
151
157
  Name of the target system description.</p>
152
158
  </li>
153
159
  </ul>
154
- <h2 id="examples">EXAMPLES</h2>
160
+ <h2 id="examples">Examples</h2>
155
161
  <ul>
156
162
  <li>
157
163
  <p>Create a copy of the system description <code>earth</code> under the name <code>moon</code>:</p>
data/manual/site/machinery-deploy.1/index.html CHANGED
@@ -23,26 +23,29 @@
23
23
 
24
24
 
25
25
 
26
- <li>Home
27
- <ul>
28
-
29
- <li class="">
30
- <a href="../machinery_main_general.1/">General</a>
31
- </li>
32
-
33
- <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
35
- </li>
36
-
37
- <li class="">
38
- <a href="../machinery_main_usecases.1/">Use cases</a>
39
- </li>
40
-
41
- <li class="">
42
- <a href="../machinery_security_implications.1/">Security Implications</a>
43
- </li>
44
-
45
- </ul>
26
+ <li class="">
27
+ <a href="../machinery_main_general.1/">General Overview</a>
28
+ </li>
29
+
30
+
31
+
32
+
33
+ <li class="">
34
+ <a href="../machinery_main_scopes.1/">Scopes</a>
35
+ </li>
36
+
37
+
38
+
39
+
40
+ <li class="">
41
+ <a href="../machinery_main_usecases.1/">Use cases</a>
42
+ </li>
43
+
44
+
45
+
46
+
47
+ <li class="">
48
+ <a href="../machinery_main_security_implications.1/">Security Implications</a>
46
49
  </li>
47
50
 
48
51
 
@@ -83,12 +86,16 @@
83
86
  <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
84
87
  </li>
85
88
 
89
+ <li class="">
90
+ <a href="../machinery-export-html.1/">Export HTML</a>
91
+ </li>
92
+
86
93
  <li class="">
87
94
  <a href="../machinery-inspect.1/">Inspect</a>
88
95
  </li>
89
96
 
90
97
  <li class="">
91
- <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
98
+ <a href="../machinery-inspect-container.1/">Inspect Container</a>
92
99
  </li>
93
100
 
94
101
  <li class="">
@@ -132,15 +139,15 @@
132
139
  </div>
133
140
  <div class="content">
134
141
  <h1 id="deploy-deploy-image-to-openstack-cloud">deploy — Deploy Image to OpenStack Cloud</h1>
135
- <h2 id="synopsis">SYNOPSIS</h2>
142
+ <h2 id="synopsis">Synopsis</h2>
136
143
  <p><code>machinery deploy</code> NAME -c CONFIG_FILE | --cloud-config=CONFIG_FILE
137
144
  [-i IMAGE_DIR | --image-dir=IMAGE_DIR]
138
145
  [-n CLOUD_IMAGE_NAME | --cloud-image-name=CLOUD_IMAGE_NAME]
139
146
  [-s | --insecure ]</p>
140
147
  <p><code>machinery</code> help [deploy]</p>
141
- <h2 id="description">DESCRIPTION</h2>
148
+ <h2 id="description">Description</h2>
142
149
  <p>The <code>deploy</code> command builds and deploys an image to an OpenStack cloud.
143
- This command is particularly useful for testing, debugging, or for validation.</p>
150
+ This command is particularly useful for testing, debugging, or validation.</p>
144
151
  <blockquote>
145
152
  <h4 id="note-set-password-for-unattended-work">NOTE: Set Password for Unattended Work</h4>
146
153
  <p>Machinery asks for a password when sourcing the configuration
@@ -152,12 +159,12 @@ the following line in your cloud configuration file (see the <code>-c</code> opt
152
159
  <p>and set the password in the <code>OS_PASSWORD</code> variable:</p>
153
160
  <p>export OS_PASSWORD=YOUR_PASSWORD</p>
154
161
  </blockquote>
155
- <h2 id="arguments">ARGUMENTS</h2>
162
+ <h2 id="arguments">Arguments</h2>
156
163
  <ul>
157
164
  <li><code>NAME</code> (required):
158
165
  Name of the system description.</li>
159
166
  </ul>
160
- <h2 id="options">OPTIONS</h2>
167
+ <h2 id="options">Options</h2>
161
168
  <ul>
162
169
  <li>
163
170
  <p><code>-c CONFIG_FILE</code>, <code>--cloud-config=CONFIG_FILE</code> (required):
@@ -178,14 +185,14 @@ the following line in your cloud configuration file (see the <code>-c</code> opt
178
185
  certificate when uploading to the cloud.</p>
179
186
  </li>
180
187
  </ul>
181
- <h2 id="prerequisites">PREREQUISITES</h2>
188
+ <h2 id="prerequisites">Prerequisites</h2>
182
189
  <ul>
183
190
  <li>The <code>deploy</code> command requires the packages <code>kiwi</code> for building the image
184
191
  and <code>python-glanceclient</code> for uploading the image to the cloud.</li>
185
192
  </ul>
186
- <h2 id="supported-architectures">SUPPORTED ARCHITECTURES</h2>
193
+ <h2 id="supported-architectures">Supported Architectures</h2>
187
194
  <p>Machinery only supports deploying x86_64 images on x86_64 systems.</p>
188
- <h2 id="examples">EXAMPLES</h2>
195
+ <h2 id="examples">Examples</h2>
189
196
  <ul>
190
197
  <li>
191
198
  <p>Build an image under the system description named <code>jeos</code>.
data/manual/site/machinery-export-autoyast.1/index.html CHANGED
@@ -23,26 +23,29 @@
23
23
 
24
24
 
25
25
 
26
- <li>Home
27
- <ul>
28
-
29
- <li class="">
30
- <a href="../machinery_main_general.1/">General</a>
31
- </li>
32
-
33
- <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
35
- </li>
36
-
37
- <li class="">
38
- <a href="../machinery_main_usecases.1/">Use cases</a>
39
- </li>
40
-
41
- <li class="">
42
- <a href="../machinery_security_implications.1/">Security Implications</a>
43
- </li>
44
-
45
- </ul>
26
+ <li class="">
27
+ <a href="../machinery_main_general.1/">General Overview</a>
28
+ </li>
29
+
30
+
31
+
32
+
33
+ <li class="">
34
+ <a href="../machinery_main_scopes.1/">Scopes</a>
35
+ </li>
36
+
37
+
38
+
39
+
40
+ <li class="">
41
+ <a href="../machinery_main_usecases.1/">Use cases</a>
42
+ </li>
43
+
44
+
45
+
46
+
47
+ <li class="">
48
+ <a href="../machinery_main_security_implications.1/">Security Implications</a>
46
49
  </li>
47
50
 
48
51
 
@@ -83,12 +86,16 @@
83
86
  <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
84
87
  </li>
85
88
 
89
+ <li class="">
90
+ <a href="../machinery-export-html.1/">Export HTML</a>
91
+ </li>
92
+
86
93
  <li class="">
87
94
  <a href="../machinery-inspect.1/">Inspect</a>
88
95
  </li>
89
96
 
90
97
  <li class="">
91
- <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
98
+ <a href="../machinery-inspect-container.1/">Inspect Container</a>
92
99
  </li>
93
100
 
94
101
  <li class="">
@@ -132,19 +139,19 @@
132
139
  </div>
133
140
  <div class="content">
134
141
  <h1 id="export-autoyast-export-system-description-as-autoyasst-profile">export-autoyast — Export System Description as AutoYasST profile</h1>
135
- <h2 id="synopsis">SYNOPSIS</h2>
136
- <p><code>machinery export-autoyast</code> -a | --autoyast-dir NAME
142
+ <h2 id="synopsis">Synopsis</h2>
143
+ <p><code>machinery export-autoyast</code> -a | --autoyast-dir=DIRECTORY NAME
137
144
  --force</p>
138
145
  <p><code>machinery</code> help export-autoyast</p>
139
- <h2 id="description">DESCRIPTION</h2>
140
- <p>The <code>export-autoyast</code> subcommand exports a stored system description as a AutoYaST
146
+ <h2 id="description">Description</h2>
147
+ <p>The <code>export-autoyast</code> subcommand exports a stored system description as an AutoYaST
141
148
  profile.</p>
142
- <h2 id="arguments">ARGUMENTS</h2>
149
+ <h2 id="arguments">Arguments</h2>
143
150
  <ul>
144
151
  <li><code>NAME</code> (required):
145
152
  Name of the system description.</li>
146
153
  </ul>
147
- <h2 id="options">OPTIONS</h2>
154
+ <h2 id="options">Options</h2>
148
155
  <ul>
149
156
  <li>
150
157
  <p><code>-a AUTOYAST_DIR</code>, <code>--autoyast-dir=AUTOYAST_DIR</code> (required):
@@ -153,10 +160,10 @@ profile.</p>
153
160
  </li>
154
161
  <li>
155
162
  <p><code>--force</code> (optional):
156
- Overwrite existing system description</p>
163
+ Overwrite an existing output directory.</p>
157
164
  </li>
158
165
  </ul>
159
- <h2 id="system-registration">SYSTEM REGISTRATION</h2>
166
+ <h2 id="system-registration">System Registration</h2>
160
167
  <ul>
161
168
  <li>To register a SLES 12 system automatically with AutoYaST, it is required to
162
169
  edit the generated profile. The following example registers the system with
@@ -172,10 +179,9 @@ profile.</p>
172
179
  </code></pre>
173
180
 
174
181
  <ul>
175
- <li>More information can be found at the SUSE AutoYaST documentation.
176
- https://www.suse.com/documentation/sles-12/singlehtml/book_autoyast/book_autoyast.html</li>
182
+ <li>More information can be found at the <a href="https://www.suse.com/documentation/sles-12/singlehtml/book_autoyast/book_autoyast.html">SUSE AutoYaST documentation</a>.</li>
177
183
  </ul>
178
- <h2 id="examples">EXAMPLES</h2>
184
+ <h2 id="examples">Examples</h2>
179
185
  <ul>
180
186
  <li>
181
187
  <p>Export the <code>myhost</code> system description to <code>/tmp/myhost-autoyast</code>:</p>