Peter Xu <pet...@redhat.com> writes: > Hi, Markus, > > On Tue, Jul 25, 2023 at 01:10:01PM +0200, Markus Armbruster wrote:
[...] >> For better or worse, we duplicate full documentation between >> MigrationParameter, MigrateSetParameters, and MigrationParameters. This >> would be the first instance where we reference instead. I'm not opposed >> to use references, but if we do, I want them used consistently. > > We discussed this over the other "switchover" parameter, but that patchset > just stranded.. > > Perhaps I just provide a pre-requisite patch to remove all the comments in > MigrateSetParameters and MigrationParameters, letting them all point to > MigrationParameter? Simplifies maintaining the doc commments. But how does it affect the documentation generated from it? Better, neutral, or worse? > One thing I should have mentioned much earlier is that this patch is for > 8.2 material. Understood. [...]