linux-kernel - Re: Re: Minor RST rant

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20200805151230.GT2674@hirez.programming.kicks-ass.net>
Date:   Wed, 5 Aug 2020 17:12:30 +0200
From:   peterz@...radead.org
To:     Vegard Nossum <vegard.nossum@...cle.com>
Cc:     NeilBrown <neilb@...e.de>, Steven Rostedt <rostedt@...dmis.org>,
        Jonathan Corbet <corbet@....net>, linux-doc@...r.kernel.org,
        LKML <linux-kernel@...r.kernel.org>
Subject: Re: Re: Minor RST rant

On Wed, Aug 05, 2020 at 04:49:50PM +0200, Vegard Nossum wrote:
> FWIW, I *really* like how the extra markup renders in a browser, and I
> don't think I'm the only one.

The thing is, I write code in a text editor, not a browser. When a
header file says: read Documentation/foo I do 'gf' and that file gets
opened in a buffer.

Needing a browser is a fail.

> If you want to read .rst files in a terminal, I would suggest using
> something like this:
> 
> $ pandoc -t plain Documentation/core-api/atomic_ops.rst | less

That doesn't help me with people sending me that abysmal shite in diff
format.