* [linux] Documentation/arch/sparc/oradax/dax-hv-api.txt and Documentation/driver-api/parport-lowlevel.rst : Form feed (^L) characters
@ 2026-06-02 9:39 Xose Vazquez Perez
2026-06-02 17:31 ` Randy Dunlap
0 siblings, 1 reply; 2+ messages in thread
From: Xose Vazquez Perez @ 2026-06-02 9:39 UTC (permalink / raw)
To: Jonathan Corbet, DOC ML
Hi,
I noticed that Documentation/arch/sparc/oradax/dax-hv-api.txt and
Documentation/driver-api/parport-lowlevel.rst contains several
legacy form feed (\f, ^L) characters used as page breaks.
I am not sure if these are still required for any specific formatting
reasons or if they should be removed.
They appear in the following lines:
$ grep -n -P '\f' Documentation/arch/sparc/oradax/dax-hv-api.txt Documentation/driver-api/parport-lowlevel.rst
./Documentation/arch/sparc/oradax/dax-hv-api.txt:66:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:128:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:176:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:228:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:284:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:342:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:397:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:454:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:504:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:554:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:609:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:667:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:719:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:779:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:830:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:887:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:943:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:995:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1048:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1105:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1156:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1216:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1272:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1326:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1381:
Coprocessor services
./Documentation/arch/sparc/oradax/dax-hv-api.txt:1433:
./Documentation/driver-api/parport-lowlevel.rst:104:
./Documentation/driver-api/parport-lowlevel.rst:504:
./Documentation/driver-api/parport-lowlevel.rst:540:
./Documentation/driver-api/parport-lowlevel.rst:586:
./Documentation/driver-api/parport-lowlevel.rst:674:
./Documentation/driver-api/parport-lowlevel.rst:709:
./Documentation/driver-api/parport-lowlevel.rst:866:
./Documentation/driver-api/parport-lowlevel.rst:1102:
./Documentation/driver-api/parport-lowlevel.rst:1188:
./Documentation/driver-api/parport-lowlevel.rst:1217:
./Documentation/driver-api/parport-lowlevel.rst:1253:
./Documentation/driver-api/parport-lowlevel.rst:1282:
./Documentation/driver-api/parport-lowlevel.rst:1319:
./Documentation/driver-api/parport-lowlevel.rst:1355:
./Documentation/driver-api/parport-lowlevel.rst:1386:
./Documentation/driver-api/parport-lowlevel.rst:1413:
./Documentation/driver-api/parport-lowlevel.rst:1444:
./Documentation/driver-api/parport-lowlevel.rst:1511:
./Documentation/driver-api/parport-lowlevel.rst:1589:
./Documentation/driver-api/parport-lowlevel.rst:1629:
./Documentation/driver-api/parport-lowlevel.rst:1661:
./Documentation/driver-api/parport-lowlevel.rst:1771:
./Documentation/driver-api/parport-lowlevel.rst:1805:
^ permalink raw reply [flat|nested] 2+ messages in thread* Re: [linux] Documentation/arch/sparc/oradax/dax-hv-api.txt and Documentation/driver-api/parport-lowlevel.rst : Form feed (^L) characters
2026-06-02 9:39 [linux] Documentation/arch/sparc/oradax/dax-hv-api.txt and Documentation/driver-api/parport-lowlevel.rst : Form feed (^L) characters Xose Vazquez Perez
@ 2026-06-02 17:31 ` Randy Dunlap
0 siblings, 0 replies; 2+ messages in thread
From: Randy Dunlap @ 2026-06-02 17:31 UTC (permalink / raw)
To: Xose Vazquez Perez, Jonathan Corbet, DOC ML
On 6/2/26 2:39 AM, Xose Vazquez Perez wrote:
> Hi,
>
> I noticed that Documentation/arch/sparc/oradax/dax-hv-api.txt and
> Documentation/driver-api/parport-lowlevel.rst contains several
> legacy form feed (\f, ^L) characters used as page breaks.
>
> I am not sure if these are still required for any specific formatting
> reasons or if they should be removed.
These form feed ^L characters seem to be ignored in the produced html output.
If someone printed the text files, they would cause page feeds.
In the case of parport-lowlevel.rst the form feeds might make the output
look nicer at the expense of wasting paper.
IMO they can all be removed.
> They appear in the following lines:
>
> $ grep -n -P '\f' Documentation/arch/sparc/oradax/dax-hv-api.txt Documentation/driver-api/parport-lowlevel.rst
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:66:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:128:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:176:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:228:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:284:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:342:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:397:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:454:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:504:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:554:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:609:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:667:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:719:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:779:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:830:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:887:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:943:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:995:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1048:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1105:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1156:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1216:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1272:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1326:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1381:
> Coprocessor services
> ./Documentation/arch/sparc/oradax/dax-hv-api.txt:1433:
>
> ./Documentation/driver-api/parport-lowlevel.rst:104:
>
> ./Documentation/driver-api/parport-lowlevel.rst:504:
>
> ./Documentation/driver-api/parport-lowlevel.rst:540:
>
> ./Documentation/driver-api/parport-lowlevel.rst:586:
>
> ./Documentation/driver-api/parport-lowlevel.rst:674:
>
> ./Documentation/driver-api/parport-lowlevel.rst:709:
>
> ./Documentation/driver-api/parport-lowlevel.rst:866:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1102:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1188:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1217:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1253:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1282:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1319:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1355:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1386:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1413:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1444:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1511:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1589:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1629:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1661:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1771:
>
> ./Documentation/driver-api/parport-lowlevel.rst:1805:
>
--
~Randy
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2026-06-02 17:31 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-06-02 9:39 [linux] Documentation/arch/sparc/oradax/dax-hv-api.txt and Documentation/driver-api/parport-lowlevel.rst : Form feed (^L) characters Xose Vazquez Perez
2026-06-02 17:31 ` Randy Dunlap
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox