id = 853
title = "Quaint English in qemu-options.hx"
state = "closed"
created_at = "2022-02-01T22:47:32.133Z"
closed_at = "2022-02-23T09:24:34.589Z"
labels = ["Closed::Fixed", "Documentation", "Storage"]
url = "https://gitlab.com/qemu-project/qemu/-/issues/853"
host-os = "Not Applicable"
host-arch = "Not Applicable"
qemu-version = "Not Applicable"
guest-os = "Not Applicable"
guest-arch = "Not Applicable"
description = """qemu-options.hx contains grammar that a native English-speaking person would never use. I had to read a sentence in that file very slowly and more than once to understand it."""
reproduce = """1. Install QEMU
2. Run a command to display documentation that includes qemu-options.hx for instance "man qemu-system-x86_64"
3. Observe "This option defines where is connected the drive ..."
4. Scratch head, figure out that "This option defines where the drive is connected ..." is the meaning."""
additional = """It is very difficult to report QEMU documentation bugs."""