Hi!
On 2023-08-14 16:06, Alejandro Colomar wrote:
> Hi!
>
> The day has come to cut the proc(5) tuna fish in very little pieces.
> As a first step, I'm pasting the contents of proc(5) into little
> files, without changing any contents (not even the formatting). For
> example see the two files at the bottom of this email.
>
> I'd like to hear any comments before pushing such a change to the repo.
> I'll soon post a branch called 'proc' to my repo (I'll ping when it's
> done), so you can observe the changes).
The sashimi is ready. Feel free to grab your portion and have a nice
supper.
I've created a signed tag 'proc-sashimi-v1' for review. It's around
100 commits, so I'm not sending them to the mailing list. Below
is a summary.
I didn't change anything from what I suggested yesterday, so I'm not
resending renderings of any page, but feel free to ask for them if
you want.
As always, all commits are GPG-signed, and the tag is also GPG-signed.
You may notice that proc_sys(5) is still huge, compared to the other
pages. I'll probably cut it in pieces in the future; I was just
tired at that point and kept the depth of the cuts limited for this
time.
Also, manual-page references are broken now, since all pages still
point to proc(5), and I didn't go page by page updating the
references to whatever the new page should be. I think that's too
much for now. If anyone wants to send updates for those, please
feel welcome! Also the references in proc(5) should be moved to the
appropriate new pages, but that's a similar story.
Cheers,
Alex
---
$ git request-pull master \
git://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git \
proc-sashimi-v1;
The following changes since commit 26ffcd4fa9a4f89ab60371e9c19fa39cae58634b:
scripts/sortman: Ignore only leading underscores or dashes (2023-08-14 15:16:59 +0200)
are available in the Git repository at:
git://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git tags/proc-sashimi-v1
for you to fetch changes up to 92cdcec79df039146e5ed42cac23cd4b7e3f9e25:
proc.5: Clean up after making sashimi of this page (2023-08-15 23:27:07 +0200)
----------------------------------------------------------------
proc(5) sashimi; v1
----------------------------------------------------------------
Alejandro Colomar (98):
proc.5: srcfix
proc.5, proc_pid_attr.5: Split /proc/PID/attr/ from proc(5)
proc.5, proc_pid_autogroup.5: Split /proc/PID/autogroup from proc(5)
proc.5, proc_pid_auxv.5: Split /proc/PID/auxv from proc(5)
proc.5, proc_pid_cgroup.5: Split /proc/PID/cgroup from proc(5)
proc.5, proc_pid_clear_refs.5: Split /proc/PID/clear_refs from proc(5)
proc.5, proc_pid_cmdline.5: Split /proc/PID/cmdline from proc(5)
proc.5, proc_pid_comm.5: Split /proc/PID/comm from proc(5)
proc.5, proc_pid_coredump_filter.5: Split /proc/PID/coredump_filter from proc(5)
proc.5, proc_pid_cpuset.5: Split /proc/PID/cpuset from proc(5)
proc.5, proc_pid_cwd.5: Split /proc/PID/cwd from proc(5)
proc.5, proc_pid_environ.5: Split /proc/PID/environ from proc(5)
proc.5, proc_pid_exe.5: Split /proc/PID/exe from proc(5)
proc.5, proc_pid_fd.5: Split /proc/PID/fd/ from proc(5)
proc.5, proc_pid_fdinfo.5: Split /proc/PID/fdinfo/ from proc(5)
proc.5, proc_pid_uid_map.5, proc_pid_gid_map.5: Split /proc/PID/[ug]id_map from proc(5)
proc.5, proc_pid_io.5: Split /proc/PID/io from proc(5)
proc.5, proc_pid_limits.5: Split /proc/PID/limits from proc(5)
proc.5, proc_pid_map_files.5: Split /proc/PID/map_files/ from proc(5)
proc.5, proc_pid_maps.5: Split /proc/PID/maps from proc(5)
proc.5, proc_pid_mem.5: Split /proc/PID/mem from proc(5)
proc.5, proc_pid_mountinfo.5: Split /proc/PID/mountinfo from proc(5)
proc.5, proc_pid_mounts.5, proc_mounts.5: Split /proc/PID/mounts (and /proc/mounts) from proc(5)
proc.5, proc_pid_mountstats.5: Split /proc/PID/mountstats from proc(5)
proc.5, proc_pid_net.5, proc_net.5: Split /proc/PID/net/ (and /proc/net/) from proc(5)
proc.5, proc_pid_ns.5: Split /proc/PID/ns/ from proc(5)
proc.5, proc_pid_numa_maps.5: Split /proc/PID/numa_maps from proc(5)
proc.5, proc_pid_oom_score_adj.5, proc_pid_oom_adj.5: Split /proc/PID/oom_score_adj (and /proc/PID/oom_adj) from proc(5)
proc.5, proc_pid_oom_score.5: Split /proc/PID/oom_score from proc(5)
proc.5, proc_pid_pagemap.5: Split /proc/PID/pagemap from proc(5)
proc.5, proc_pid_personality.5: Split /proc/PID/personality from proc(5)
proc.5, proc_pid_root.5: Split /proc/PID/root/ from proc(5)
proc.5, proc_pid_projid_map.5: Split /proc/PID/projid_map from proc(5)
proc.5, proc_pid_seccomp.5: Split /proc/PID/seccomp from proc(5)
proc.5, proc_pid_setgroups.5: Split /proc/PID/setgroups from proc(5)
proc.5, proc_pid_smaps.5: Split /proc/PID/smaps from proc(5); XXX: what's s in smaps?
proc.5, proc_pid_stack.5: Split /proc/PID/stack from proc(5)
proc.5, proc_pid_stat.5: Split /proc/PID/stat from proc(5)
proc.5, proc_pid_statm.5: Split /proc/PID/statm from proc(5)
proc.5, proc_pid_status.5: Split /proc/PID/status from proc(5)
proc.5, proc_pid_syscall.5: Split /proc/PID/syscall from proc(5)
proc.5, proc_pid_timers.5: Split /proc/PID/timers from proc(5)
proc.5, proc_pid_timerslack_ns.5: Split /proc/PID/timerslack_ns from proc(5)
proc.5, proc_pid_wchan.5: Split /proc/PID/wchan from proc(5)
proc.5, proc_pid.5, proc_self.5: Split /proc/PID/ (and /proc/self/) from proc(5)
proc.5, proc_pid_task.5, proc_tid.5, proc_thread-self.5: Split /proc/PID/task/ (and /proc/TID/, /proc/thread-self/) from proc(5)
proc.5, proc_tid_children.5: Split /proc/TID/children from proc(5)
proc.5, proc_apm.5: Split /proc/apm from proc(5)
proc.5, proc_buddyinfo.5: Split /proc/buddyinfo from proc(5)
proc.5, proc_bus.5: Split /proc/bus/ from proc(5)
proc.5, proc_cgroups.5: Split /proc/cgroups from proc(5)
proc.5, proc_cmdline.5: Split /proc/cmdline from proc(5)
proc.5, proc_config.gz.5: Split /proc/config.gz from proc(5)
proc.5, proc_crypto.5: Split /proc/crypto from proc(5)
proc.5, proc_cpuinfo.5: Split /proc/cpuinfo from proc(5)
proc.5, proc_devices.5: Split /proc/devices from proc(5)
proc.5, proc_diskstats.5: Split /proc/diskstats from proc(5)
proc.5, proc_dma.5: Split /proc/dma from proc(5)
proc.5, proc_driver.5: Split /proc/driver/ from proc(5)
proc.5, proc_execdomains.5: Split /proc/execdomains from proc(5)
proc.5, proc_fb.5: Split /proc/fb from proc(5)
proc.5, proc_filesystems.5: Split /proc/filesystems from proc(5)
proc.5, proc_fs.5: Split /proc/fs/ from proc(5)
proc.5, proc_ide.5: Split /proc/ide/ from proc(5)
proc.5, proc_interrupts.5: Split /proc/interrupts from proc(5)
proc.5, proc_iomem.5: Split /proc/iomem from proc(5)
proc.5, proc_ioports.5: Split /proc/ioports from proc(5)
proc.5, proc_kallsyms.5, proc_ksyms.5: Split /proc/kallsyms (and /proc/ksyms) from proc(5)
proc.5, proc_kcore.5: Split /proc/kcore from proc(5)
proc.5, proc_keys.5, proc_key-users.5: Split /proc/keys (and /proc/key-users) from proc(5)
proc.5, proc_kmsg.5: Split /proc/kmsg from proc(5)
proc.5, proc_kpagecgroup.5: Split /proc/kpagecgroup from proc(5)
proc.5, proc_kpagecount.5: Split /proc/kpagecount from proc(5)
proc.5, proc_kpageflags.5: Split /proc/kpageflags from proc(5)
proc.5, proc_loadavg.5: Split /proc/loadavg from proc(5)
proc.5, proc_locks.5: Split /proc/locks from proc(5)
proc.5, proc_malloc.5: Split /proc/malloc from proc(5)
proc.5, proc_meminfo.5: Split /proc/meminfo from proc(5)
proc.5, proc_modules.5: Split /proc/modules from proc(5)
proc.5, proc_mtrr.5: Split /proc/mtrr from proc(5)
proc.5, proc_partitions.5: Split /proc/partitions from proc(5)
proc.5, proc_pci.5: Split /proc/pci from proc(5)
proc.5, proc_profile.5: Split /proc/profile from proc(5)
proc.5, proc_scsi.5: Split /proc/scsi/ from proc(5)
proc.5, proc_slabinfo.5: Split /proc/slabinfo from proc(5)
proc.5, proc_stat.5: Split /proc/stat from proc(5)
proc.5, proc_swaps.5: Split /proc/swaps from proc(5)
proc.5, proc_sys.5: Split /proc/sys/ from proc(5)
proc.5, proc_sysrq-trigger.5: Split /proc/sysrq-trigger from proc(5)
proc.5, proc_sysvipc.5: Split /proc/sysvipc/ from proc(5)
proc.5, proc_timer_list.5: Split /proc/timer_list from proc(5)
proc.5, proc_timer_stats.5: Split /proc/timer_stats from proc(5)
proc.5, proc_tty.5: Split /proc/tty from proc(5)
proc.5, proc_uptime.5: Split /proc/uptime from proc(5)
proc.5, proc_version.5: Split /proc/version from proc(5)
proc.5, proc_vmstat.5: Split /proc/vmstat from proc(5)
proc.5, proc_zoneinfo.5: Split /proc/zoneinfo from proc(5)
proc.5: Clean up after making sashimi of this page
man5/proc.5 | 6722 +----------------------------------------------------------------------------------------------------------------------------------------------------
man5/proc_apm.5 | 17 +
man5/proc_buddyinfo.5 | 58 ++
man5/proc_bus.5 | 35 +
man5/proc_cgroups.5 | 16 +
man5/proc_cmdline.5 | 22 +
man5/proc_config.gz.5 | 40 +
man5/proc_cpuinfo.5 | 24 +
man5/proc_crypto.5 | 26 +
man5/proc_devices.5 | 16 +
man5/proc_diskstats.5 | 21 +
man5/proc_dma.5 | 16 +
man5/proc_driver.5 | 15 +
man5/proc_execdomains.5 | 16 +
man5/proc_fb.5 | 17 +
man5/proc_filesystems.5 | 33 +
man5/proc_fs.5 | 18 +
man5/proc_ide.5 | 37 +
man5/proc_interrupts.5 | 22 +
man5/proc_iomem.5 | 15 +
man5/proc_ioports.5 | 16 +
man5/proc_kallsyms.5 | 25 +
man5/proc_kcore.5 | 24 +
man5/proc_key-users.5 | 1 +
man5/proc_keys.5 | 20 +
man5/proc_kmsg.5 | 28 +
man5/proc_kpagecgroup.5 | 25 +
man5/proc_kpagecount.5 | 24 +
man5/proc_kpageflags.5 | 75 ++
man5/proc_ksyms.5 | 1 +
man5/proc_loadavg.5 | 27 +
man5/proc_locks.5 | 118 +++
man5/proc_malloc.5 | 18 +
man5/proc_meminfo.5 | 327 ++++++++
man5/proc_modules.5 | 17 +
man5/proc_mounts.5 | 1 +
man5/proc_mtrr.5 | 24 +
man5/proc_net.5 | 1 +
man5/proc_partitions.5 | 16 +
man5/proc_pci.5 | 28 +
man5/proc_pid.5 | 73 ++
man5/proc_pid_attr.5 | 137 ++++
man5/proc_pid_autogroup.5 | 17 +
man5/proc_pid_auxv.5 | 27 +
man5/proc_pid_cgroup.5 | 16 +
man5/proc_pid_clear_refs.5 | 88 ++
man5/proc_pid_cmdline.5 | 49 ++
man5/proc_pid_comm.5 | 49 ++
man5/proc_pid_coredump_filter.5 | 16 +
man5/proc_pid_cpuset.5 | 17 +
man5/proc_pid_cwd.5 | 36 +
man5/proc_pid_environ.5 | 48 ++
man5/proc_pid_exe.5 | 59 ++
man5/proc_pid_fd.5 | 161 ++++
man5/proc_pid_fdinfo.5 | 300 +++++++
man5/proc_pid_gid_map.5 | 1 +
man5/proc_pid_io.5 | 98 +++
man5/proc_pid_limits.5 | 25 +
man5/proc_pid_map_files.5 | 72 ++
man5/proc_pid_maps.5 | 157 ++++
man5/proc_pid_mem.5 | 24 +
man5/proc_pid_mountinfo.5 | 124 +++
man5/proc_pid_mounts.5 | 49 ++
man5/proc_pid_mountstats.5 | 46 ++
man5/proc_pid_net.5 | 298 +++++++
man5/proc_pid_ns.5 | 20 +
man5/proc_pid_numa_maps.5 | 16 +
man5/proc_pid_oom_adj.5 | 1 +
man5/proc_pid_oom_score.5 | 58 ++
man5/proc_pid_oom_score_adj.5 | 117 +++
man5/proc_pid_pagemap.5 | 77 ++
man5/proc_pid_personality.5 | 23 +
man5/proc_pid_projid_map.5 | 17 +
man5/proc_pid_root.5 | 75 ++
man5/proc_pid_seccomp.5 | 36 +
man5/proc_pid_setgroups.5 | 16 +
man5/proc_pid_smaps.5 | 128 +++
man5/proc_pid_stack.5 | 25 +
man5/proc_pid_stat.5 | 380 +++++++++
man5/proc_pid_statm.5 | 46 ++
man5/proc_pid_status.5 | 366 +++++++++
man5/proc_pid_syscall.5 | 33 +
man5/proc_pid_task.5 | 97 +++
man5/proc_pid_timers.5 | 83 ++
man5/proc_pid_timerslack_ns.5 | 41 +
man5/proc_pid_uid_map.5 | 20 +
man5/proc_pid_wchan.5 | 21 +
man5/proc_profile.5 | 24 +
man5/proc_scsi.5 | 66 ++
man5/proc_self.5 | 1 +
man5/proc_slabinfo.5 | 18 +
man5/proc_stat.5 | 140 ++++
man5/proc_swaps.5 | 17 +
man5/proc_sys.5 | 1623 ++++++++++++++++++++++++++++++++++++
man5/proc_sysrq-trigger.5 | 25 +
man5/proc_sysvipc.5 | 25 +
man5/proc_thread-self.5 | 1 +
man5/proc_tid.5 | 1 +
man5/proc_tid_children.5 | 37 +
man5/proc_timer_list.5 | 18 +
man5/proc_timer_stats.5 | 117 +++
man5/proc_tty.5 | 16 +
man5/proc_uptime.5 | 17 +
man5/proc_version.5 | 27 +
man5/proc_vmstat.5 | 702 ++++++++++++++++
man5/proc_zoneinfo.5 | 17 +
106 files changed, 7860 insertions(+), 6717 deletions(-)
create mode 100644 man5/proc_apm.5
create mode 100644 man5/proc_buddyinfo.5
create mode 100644 man5/proc_bus.5
create mode 100644 man5/proc_cgroups.5
create mode 100644 man5/proc_cmdline.5
create mode 100644 man5/proc_config.gz.5
create mode 100644 man5/proc_cpuinfo.5
create mode 100644 man5/proc_crypto.5
create mode 100644 man5/proc_devices.5
create mode 100644 man5/proc_diskstats.5
create mode 100644 man5/proc_dma.5
create mode 100644 man5/proc_driver.5
create mode 100644 man5/proc_execdomains.5
create mode 100644 man5/proc_fb.5
create mode 100644 man5/proc_filesystems.5
create mode 100644 man5/proc_fs.5
create mode 100644 man5/proc_ide.5
create mode 100644 man5/proc_interrupts.5
create mode 100644 man5/proc_iomem.5
create mode 100644 man5/proc_ioports.5
create mode 100644 man5/proc_kallsyms.5
create mode 100644 man5/proc_kcore.5
create mode 100644 man5/proc_key-users.5
create mode 100644 man5/proc_keys.5
create mode 100644 man5/proc_kmsg.5
create mode 100644 man5/proc_kpagecgroup.5
create mode 100644 man5/proc_kpagecount.5
create mode 100644 man5/proc_kpageflags.5
create mode 100644 man5/proc_ksyms.5
create mode 100644 man5/proc_loadavg.5
create mode 100644 man5/proc_locks.5
create mode 100644 man5/proc_malloc.5
create mode 100644 man5/proc_meminfo.5
create mode 100644 man5/proc_modules.5
create mode 100644 man5/proc_mounts.5
create mode 100644 man5/proc_mtrr.5
create mode 100644 man5/proc_net.5
create mode 100644 man5/proc_partitions.5
create mode 100644 man5/proc_pci.5
create mode 100644 man5/proc_pid.5
create mode 100644 man5/proc_pid_attr.5
create mode 100644 man5/proc_pid_autogroup.5
create mode 100644 man5/proc_pid_auxv.5
create mode 100644 man5/proc_pid_cgroup.5
create mode 100644 man5/proc_pid_clear_refs.5
create mode 100644 man5/proc_pid_cmdline.5
create mode 100644 man5/proc_pid_comm.5
create mode 100644 man5/proc_pid_coredump_filter.5
create mode 100644 man5/proc_pid_cpuset.5
create mode 100644 man5/proc_pid_cwd.5
create mode 100644 man5/proc_pid_environ.5
create mode 100644 man5/proc_pid_exe.5
create mode 100644 man5/proc_pid_fd.5
create mode 100644 man5/proc_pid_fdinfo.5
create mode 100644 man5/proc_pid_gid_map.5
create mode 100644 man5/proc_pid_io.5
create mode 100644 man5/proc_pid_limits.5
create mode 100644 man5/proc_pid_map_files.5
create mode 100644 man5/proc_pid_maps.5
create mode 100644 man5/proc_pid_mem.5
create mode 100644 man5/proc_pid_mountinfo.5
create mode 100644 man5/proc_pid_mounts.5
create mode 100644 man5/proc_pid_mountstats.5
create mode 100644 man5/proc_pid_net.5
create mode 100644 man5/proc_pid_ns.5
create mode 100644 man5/proc_pid_numa_maps.5
create mode 100644 man5/proc_pid_oom_adj.5
create mode 100644 man5/proc_pid_oom_score.5
create mode 100644 man5/proc_pid_oom_score_adj.5
create mode 100644 man5/proc_pid_pagemap.5
create mode 100644 man5/proc_pid_personality.5
create mode 100644 man5/proc_pid_projid_map.5
create mode 100644 man5/proc_pid_root.5
create mode 100644 man5/proc_pid_seccomp.5
create mode 100644 man5/proc_pid_setgroups.5
create mode 100644 man5/proc_pid_smaps.5
create mode 100644 man5/proc_pid_stack.5
create mode 100644 man5/proc_pid_stat.5
create mode 100644 man5/proc_pid_statm.5
create mode 100644 man5/proc_pid_status.5
create mode 100644 man5/proc_pid_syscall.5
create mode 100644 man5/proc_pid_task.5
create mode 100644 man5/proc_pid_timers.5
create mode 100644 man5/proc_pid_timerslack_ns.5
create mode 100644 man5/proc_pid_uid_map.5
create mode 100644 man5/proc_pid_wchan.5
create mode 100644 man5/proc_profile.5
create mode 100644 man5/proc_scsi.5
create mode 100644 man5/proc_self.5
create mode 100644 man5/proc_slabinfo.5
create mode 100644 man5/proc_stat.5
create mode 100644 man5/proc_swaps.5
create mode 100644 man5/proc_sys.5
create mode 100644 man5/proc_sysrq-trigger.5
create mode 100644 man5/proc_sysvipc.5
create mode 100644 man5/proc_thread-self.5
create mode 100644 man5/proc_tid.5
create mode 100644 man5/proc_tid_children.5
create mode 100644 man5/proc_timer_list.5
create mode 100644 man5/proc_timer_stats.5
create mode 100644 man5/proc_tty.5
create mode 100644 man5/proc_uptime.5
create mode 100644 man5/proc_version.5
create mode 100644 man5/proc_vmstat.5
create mode 100644 man5/proc_zoneinfo.5
--
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5
Attachment:
OpenPGP_signature
Description: OpenPGP digital signature
