Re: [PATCH] etc: import changes to texi2pod.pl from gcc

Project / Subsystem

binutils / etc

Date

2026-08-05

Proposer

Andrew Burgess <aburgess@redhat.com>

Source type

public_inbox

Consensus

Proposed

Sentiment

—/10

Technical tradeoffs

  • • Importing GCC's script risks introducing GCC-specific behaviors or dependencies into binutils.
  • • Reverting GCC commit 386c402747d2bc6bad3e1bc2f9383d4d669576e0 might mask an underlying issue in GCC's texi2pod.pl that could surface later.

All attributes

project
binutils
subsystem
etc
patch_id
—
discussion_id
87v79olsxh.fsf@redhat.com
source_type
public_inbox
title
Re: [PATCH] etc: import changes to texi2pod.pl from gcc
headline
etc: import changes to texi2pod.pl from gcc
tldr
Sync binutils' texi2pod.pl script with GCC's, adding @option and @table @option support.
proposer
Andrew Burgess <aburgess@redhat.com>
consensus
Proposed
outcome
proposed
sentiment_score
—
technical_tradeoffs
  • • Importing GCC's script risks introducing GCC-specific behaviors or dependencies into binutils.
  • • Reverting GCC commit 386c402747d2bc6bad3e1bc2f9383d4d669576e0 might mask an underlying issue in GCC's texi2pod.pl that could surface later.
series_id
—
series_role
standalone
series_parts
[]
tags
  • • documentation
  • • build
  • • scripting
  • • texinfo
  • • perl
bugzilla_url
—
date
2026-08-05T00:00:00.000Z

Re: [PATCH] etc: import changes to texi2pod.pl from gcc

Andrew Burgess proposes syncing binutils’ texi2pod.pl script with the version from GCC. This addresses limitations in formatting @option{—text} and @table @option, which were affecting GDB documentation cleanup. The imported GCC version required local adjustments to support —no-split, TARGET as a man page section, and to revert a GCC change that affected list formatting. Burgess also added trivial support for @table @option, which has been submitted to the GCC mailing list.