Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.debian.user > #223905 > unrolled thread

[debian-reference manual] bullet point sign and its content misplaced

Back to article view | Back to linux.debian.user

Contents

  [debian-reference manual] bullet point sign and its content misplaced Vipul <finn02+debian@disroot.org> - 2020-06-23 11:20 +0200
    Re: [debian-reference manual] bullet point sign and its content  misplaced l0f4r0@tuta.io - 2020-06-23 13:00 +0200
      Re: [debian-reference manual] bullet point sign and its content  misplaced Vipul <finn02+debian@disroot.org> - 2020-06-23 14:10 +0200
        Re: [debian-reference manual] bullet point sign and its content  misplaced l0f4r0@tuta.io - 2020-06-23 17:40 +0200
    Re: [debian-reference manual] bullet point sign and its content misplaced Kenneth Parker <sea7kenp@gmail.com> - 2020-06-23 13:30 +0200
      Re: [debian-reference manual] bullet point sign and its content  misplaced Nicolas George <george@nsup.org> - 2020-06-23 13:40 +0200
        Re: [debian-reference manual] bullet point sign and its content  misplaced Finn <mail.finn@disroot.org> - 2020-06-23 14:00 +0200
          Re: [debian-reference manual] bullet point sign and its content  misplaced Charles Curley <charlescurley@charlescurley.com> - 2020-06-23 19:50 +0200
            Re: [debian-reference manual] bullet point sign and its content  misplaced Finn <mail.finn@disroot.org> - 2020-06-24 03:10 +0200
              Re: [debian-reference manual] bullet point sign and its content  misplaced davidson <davidson@freevolt.org> - 2020-06-24 04:00 +0200

#223905 — [debian-reference manual] bullet point sign and its content misplaced

Hi,

At some places, in debian-reference manual[1], bullet point and its
content is misplaced, that is content is present just below the bullet sign.

Here some examples,

- Removable Storage Device (Section 10.1.7)[2]
> "USB flash drive"

Sentence present just below bullet sign, and similarly there are many
more place like this.

- Filesystem choice for sharing data (Section 10.1.8)[3]
>  Partitioning them with fdisk(8), cfdisk(8) or parted(8) (see Section
> 9.5.2, “Disk partition configuration”) into a single primary partition
> and to mark it as the following.

- Sharing data via network (Section 10.1.9)[4]
> Encrypt it with SSL/TLS


I don't think author has intention to show these sentences like this. I
looked into source code of debian-reference manual[5], but found nothing
unusual i.e. if you look into source code of "Removable Storage Device"
(Section 10.1.7)[6], there is no syntactically difference in first and
second line, despite that "USB flash drive" sentence isn't present in
same line like "Hard disk drive" sentence.

First I was thinking that may be debian.org is running older release of
manual; but README file mentioned it clearly, debian.org is running
latest release[7]. Is it some kind of bug? Or I'm missing something.

[1]: https://www.debian.org/doc/manuals/debian-reference/
[2]:
https://www.debian.org/doc/manuals/debian-reference/ch10.en.html#_removable_storage_device
[3]:
https://www.debian.org/doc/manuals/debian-reference/ch10.en.html#_filesystem_choice_for_sharing_data
[4]:
https://www.debian.org/doc/manuals/debian-reference/ch10.en.html#_sharing_data_via_network
[5]: https://salsa.debian.org/debian/debian-reference/
[6]:
https://salsa.debian.org/debian/debian-reference/-/blob/master/asciidoc/10_datamngt.txt#L256
[7]:
https://salsa.debian.org/debian/debian-reference/-/tree/master#publication-to-the-wwwdebianorg-servers


Cheers,
Vipul

[toc] | [next] | [standalone]

#223906 — Re: [debian-reference manual] bullet point sign and its content misplaced

Hi,

23 juin 2020 à 10:58 de finn02+debian@disroot.org:

> At some places, in debian-reference manual[1], bullet point and its
> content is misplaced, that is content is present just below the bullet sign.
>
Either I don't understand your description, or I have no issue at all from my side.
You see an empty bullet point with its related text just below?
Have you tried different web browsers? Do you have specific browser addons installed?

Anyway, if there is a real issue, debian-doc@lists.debian.org will certainly be more appropriate ;)

Best regards,
l0f4r0

[toc] | [prev] | [next] | [standalone]

#223911 — Re: [debian-reference manual] bullet point sign and its content misplaced

l0f4r0@tuta.io wrote:

> You see an empty bullet point with its related text just below? 
Yep.

> Have you tried different web browsers?
Not yet, I reproduced this only on Firefox browser. Just checked, I
cannot reproduce this on Chromium browser; seems like issue is with Firefox.

> Do you have specific browser addons installed?
Yes, but I can reproduce this behavior on fresh "new profile" of
Firefox. Can you reproduce this on Firefox?

[toc] | [prev] | [next] | [standalone]

#223912 — Re: [debian-reference manual] bullet point sign and its content misplaced

Hi,

23 juin 2020 à 13:43 de finn02+debian@disroot.org:

> Yes, but I can reproduce this behavior on fresh "new profile" of
> Firefox. Can you reproduce this on Firefox?
>
Confirmed on FF indeed!

Best regards,
l0f4r0

[toc] | [prev] | [next] | [standalone]

#223908

[Multipart message — attachments visible in raw view] — view raw

On Tue, Jun 23, 2020, 5:15 AM Vipul <finn02+debian@disroot.org> wrote:

> Hi,
>
> At some places, in debian-reference manual[1], bullet point and its
> content is misplaced, that is content is present just below the bullet
> sign.
>
> Here some examples,
>
> - Removable Storage Device (Section 10.1.7)[2]
> > "USB flash drive"
>
> Sentence present just below bullet sign, and similarly there are many
> more place like this.
>
> - Filesystem choice for sharing data (Section 10.1.8)[3]
> >  Partitioning them with fdisk(8), cfdisk(8) or parted(8) (see Section
> > 9.5.2, “Disk partition configuration”) into a single primary partition
> > and to mark it as the following.
>
> - Sharing data via network (Section 10.1.9)[4]
> > Encrypt it with SSL/TLS
>
>
> I don't think author has intention to show these sentences like this. I
> looked into source code of debian-reference manual[5], but found nothing
> unusual i.e. if you look into source code of "Removable Storage Device"
> (Section 10.1.7)[6], there is no syntactically difference in first and
> second line, despite that "USB flash drive" sentence isn't present in
> same line like "Hard disk drive" sentence.
>
> First I was thinking that may be debian.org is running older release of
> manual; but README file mentioned it clearly, debian.org is running
> latest release[7]. Is it some kind of bug? Or I'm missing something.
>
> [1]: https://www.debian.org/doc/manuals/debian-reference/
> [2]:
>
> https://www.debian.org/doc/manuals/debian-reference/ch10.en.html#_removable_storage_device


I picked this one as an example.  Firefox on Android showed what you
described, on the first Bullet Point.

*However*,  the DuckDuckGo Android Browser put the content on the same line
as the Bullet Point.

So I back up the suggestion by the other responder to try other Browsers.

(As to Firefox, don't know what to suggest).

<snip rest>

Kenneth Parker

[toc] | [prev] | [next] | [standalone]

#223909 — Re: [debian-reference manual] bullet point sign and its content misplaced

[Multipart message — attachments visible in raw view] — view raw

Kenneth Parker (12020-06-23):
> I picked this one as an example.  Firefox on Android showed what you
> described, on the first Bullet Point.
> 
> *However*,  the DuckDuckGo Android Browser put the content on the same line
> as the Bullet Point.
> 
> So I back up the suggestion by the other responder to try other Browsers.

With Firefox, the DOM inspector shows:

  <a id="_removable_storage_device>...</a>
  <div class="itemizedlist">
    <a id="_removable_storage_device>...</a>
    <ul class="itemizedlist">
      <a id="_removable_storage_device>...</a>
      <li class="listitem">...</li>
      <li class="listitem">...</li>

In the source code of the page, we see:

<h3 class="title"><a id="_removable_storage_device"/>10.1.7. Removable storage device</h3>

It is obviously a bug in Firefox's HTML parser, probably linked to the
empty <a> element denoted with the slash at the end.

That could be better written:

<h3 class="title" id="_removable_storage_device">10.1.7. Removable storage device</h3>

though.

Regards,

-- 
  Nicolas George

[toc] | [prev] | [next] | [standalone]

#223910 — Re: [debian-reference manual] bullet point sign and its content misplaced

> It is obviously a bug in Firefox's HTML parser, probably linked to the
> empty <a> element denoted with the slash at the end.

Thanks, I'll report it to Bugzilla.

[toc] | [prev] | [next] | [standalone]

#223913 — Re: [debian-reference manual] bullet point sign and its content misplaced

On Tue, 23 Jun 2020 11:53:53 +0000
Finn <mail.finn@disroot.org> wrote:

> > It is obviously a bug in Firefox's HTML parser, probably linked to
> > the empty <a> element denoted with the slash at the end.  
> 
> Thanks, I'll report it to Bugzilla.

Before you do that, are you sure what you see isn't Firefox's reaction
to buggy HTML? Have you run the code through an HTML validator? e.g.
http://validator.w3.org/check

-- 
Does anybody read signatures any more?

https://charlescurley.com
https://charlescurley.com/blog/

[toc] | [prev] | [next] | [standalone]

#223922 — Re: [debian-reference manual] bullet point sign and its content misplaced

Charles Curley wrote:

> Before you do that, are you sure what you see isn't Firefox's reaction
> to buggy HTML? Have you run the code through an HTML validator?

Thanks for reminding that. HTML validator shows only one error, with
"width" attribute[1].

[1]:
https://validator.w3.org/check?uri=https%3A%2F%2Fwww.debian.org%2Fdoc%2Fmanuals%2Fdebian-reference%2Fch10.en.html%23_removable_storage_device&charset=%28detect+automatically%29&doctype=Inline&group=0

[toc] | [prev] | [next] | [standalone]

#223926 — Re: [debian-reference manual] bullet point sign and its content misplaced

On Wed, 24 Jun 2020 Finn wrote:
> Charles Curley wrote:
>
>> Before you do that, are you sure what you see isn't Firefox's reaction
>> to buggy HTML? Have you run the code through an HTML validator?
>
> Thanks for reminding that. HTML validator shows only one error, with
> "width" attribute[1].
>
> [1]:
> https://validator.w3.org/check?uri=https%3A%2F%2Fwww.debian.org%2Fdoc%2Fmanuals%2Fdebian-reference%2Fch10.en.html%23_removable_storage_device&charset=%28detect+automatically%29&doctype=Inline&group=0

I see this:

  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml">
                                      ^^^^^

and I see a lot of empty elements written in combined start-end form,
like this,

   <tagname attribs />

but without any space preceding the forward slash at the end of the tag.

And by "a lot", I mean one dozen and two hundreds:

   $ grep -o '<[^<]*[^[:blank:]]/>' ch10.en.html | wc -l # NB[1]
   212

   $ grep -o '<[^<]*[^[:blank:]]/>' ch10.en.html |
   >  grep -o "^<[[:alpha:]]*" |
   >  tr -d "<" | sort | uniq -c
      67 a
      15 br
      54 col
       2 hr
      67 img
       5 link
       2 meta

In ye olde book about xhtml[2], it is written:

  Section 16.3.3  Handling Empty Elements

   In XML, and thus XHTML, every tag must have a corresponding end
   tag---even those that aren't allowed to contain other tags or
   content. Accordingly, XHTML expects the line break to appear as
   <br></br> in your document. Ugh.

   Fortunately, there is an acceptable alternative: include a slash
   before the closing bracket of the tag to indicate its ending (eg,
   <br />). If the tag has attributes, the slash comes after, the
   slash comes after all the attributes so that an image could be
   defined as:

       <img src="kumquat.gif" />

   While this notation may seem foreign and annoying to an HTML
   author, it actually serves a useful purpose. Any XHTML element that
   has no content can be written this way. Thus, an empty paragraph
   can be written as <p />, and an empty table cell can be written as
   <td />. This is a handy way to mark empty table cells.

   Clever as it may seem, writing empty tags in this abbreviated way
   may confuse HTML browsers. To avoid compatibility problems, you can
   fool the HTML browsers by placing a space before the forward slash
   in an empty element using the XHTML version of its end tag. For
   example, use <br />, with a space between the "br" and '/', instead
   of the XHTML equivalents <br/> and <br></br>. Table 16-1 contains
   all of the empty HTML tags, expressed in their acceptable XHTML
   (transitional DTD) forms.

  Table 16-1. *HTML empty tags in XHTML format*

   <area />     <base />   <basefont />
   <br />       <col />    <frame />
   <hr />       <img />    <input />
   <isindex />  <link />   <meta />
   <param />


NOTES

1. "Every time you attempt to parse HTML with regular expressions, the
     unholy child weeps the blood of virgins, and Russian hackers pwn
     your webapp."
    stackoverflow.com/questions/1732348/regex-match-open-tags-except-xhtml-self-contained-tags/1732454#1732454

2. Musciano and Kennedy 2007, "HTML & XHTML the Definitive Guide" (6ed)


-- 
Firstly, you must always implicitly obey orders, without attempting to
form any opinion of your own respecting their propriety. Secondly, you
must consider every man your enemy who speaks ill of your king; and
thirdly, you must hate a Frenchman, as you do the devil. --H. Nelson

[toc] | [prev] | [standalone]

Back to top | Article view | linux.debian.user

csiph-web