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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
[[PrefaceTypographicConventions]]
=== Typographic Conventions
The following table shows the typographic conventions that are used in this guide.
// https://github.com/oreillymedia/orm_book_samples/blob/master/asciidoc_only/preface.adoc
// AsciiDoc allows alternative markup for some styles, specifically
// 'single quotes' and _underlines_ for italics and +plus signs+ and
// `backticks` for monospaces.
// Asciidoctor’s modern mode is more strict, and only allows _underline_
// italics and `backtick` monospaces.
// https://asciidoctor.org/docs/migration/
.Typographic Conventions
[options="header",cols="1,3,3"]
|===
|Style|Description|Example
|_Italic_ |File names, folder names, and extensions |_C:\Development\wireshark_.
|`Monospace` |Commands, flags, and environment variables|CMake’s `-G` option.
|**`Bold Monospace`** |Commands that should be run by the user|Run **`cmake -G Ninja ..`**.
|btn:[Button] |Dialog and window buttons |Press btn:[Launch] to go to the Moon.
|kbd:[Key] |Keyboard shortcut |Press kbd:[Ctrl+Down] to move to the next packet.
|menu:Menu[] |Menu item |Select menu:Go[Next Packet] to move to the next packet.
|===
==== Admonitions
Important and notable items are marked as follows:
[WARNING]
.This is a warning
====
You should pay attention to a warning, otherwise data loss might occur.
====
[NOTE]
.This is a note
====
A note will point you to common mistakes and things that might not be obvious.
====
[TIP]
.This is a tip
====
Tips are helpful for your everyday work using Wireshark.
====
==== Shell Prompt and Source Code Examples
.Bourne shell, normal user
----
$ # This is a comment
$ git config --global log.abbrevcommit true
----
.Bourne shell, root user
----
# # This is a comment
# ninja install
----
.Command Prompt (cmd.exe)
----
>rem This is a comment
>cd C:\Development
----
.PowerShell
----
PS$># This is a comment
PS$> choco list -l
----
.C Source Code
----
#include "config.h"
/* This method dissects foos */
static int
dissect_foo_message(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree _U_, void *data _U_)
{
/* TODO: implement your dissecting code */
return tvb_captured_length(tvb);
}
----
|
