File: README.md

package info (click to toggle)
android-platform-system-tools-hidl 10.0.0%2Br36-3.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,936 kB
  • sloc: cpp: 21,933; yacc: 1,416; java: 1,239; lex: 496; sh: 360; python: 44; xml: 20; makefile: 12
file content (35 lines) | stat: -rw-r--r-- 896 bytes parent folder | download | duplicates (3)
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
# Install

~~~
$ m -j hidl-doc
~~~

# Usage

View usage info:

~~~
$ ./bin/hidl-doc -h
~~~

Parse the audio `types.hal` file in the Android repo and output
generated HTML reference to the reference directory. Enable verbose mode:

~~~
$ ./bin/hidl-doc -v -i /path/to/android/hardware/interfaces/audio/2.0/types.hal \
  -o /path/to/output/en/reference/hidl/
~~~

Parse all HAL files in the Android `/hardware/interfaces/` directory
and output generated HTML reference docs to reference directory. Skip files
that encounter doc parse errors:

~~~
$ ./bin/hidl-doc -v -s -i /path/to/android/hardware/interfaces/ \
  -o /path/to/output/en/reference/hidl/
~~~
# Templates

HTML templates are used to generate the output docs and are in the
`resources/template/` directory. Since these files are bundled up in the fat jar
file, if you make any changes to the templates, `hidl-doc.jar` must be rebuilt.