Document the left/right menu panelize command

[mc-butler]

Important

This issue was migrated from Trac:

Origin	https://midnight-commander.org/ticket/3767
Reporter	cri (cri@….org)

I can't find any information in the internal help, or man page, or wiki, about the "Panelize" command in the "Left" or "Right" menu.

I suspect this is related to the (well documented) "External panelize" command, but when I select it, I'm left clueless with an empty panel. Now what?

Note

Original attachments:

• 0001-Document-panelization-related-code.patch (raw) by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC
• 0002-Make-result-of-External-panelize-restorable.patch (raw) by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC
• 0003-Rename-Panelize-menu-command-to-Restore-panelization.patch (raw) by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC
• 0004-Document-the-Restore-panelization-menu-command--NEEDS-WORK.patch (raw) by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC

[mc-butler]

Changed by cri (cri@….org) on Feb 15, 2017 at 23:45 UTC (comment 1)

Since this is more a help request than a bug report, maybe it can be better answered on the mailing list.

I dug into the source code and posted more information at:
https://mail.gnome.org/archives/mc/2017-February/msg00010.html

[mc-butler]

Changed by mooffie (@mooffie) on Feb 18, 2017 at 21:38 UTC (comment 2)

• Status changed from new to accepted
• Owner set to mooffie
• Summary changed from Please document the left/right menu panelize command to Document the left/right menu panelize command

I'm attaching a series of patches to fix this issue. "A patch is worth a thousand words".

[mc-butler]

Changed by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC

• Attachment 0001-Document-panelization-related-code.patch (raw) added

[mc-butler]

Changed by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC

• Attachment 0002-Make-result-of-External-panelize-restorable.patch (raw) added

[mc-butler]

Changed by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC

• Attachment 0003-Rename-Panelize-menu-command-to-Restore-panelization.patch (raw) added

[mc-butler]

Changed by mooffie (@mooffie) on Feb 18, 2017 at 21:40 UTC

• Attachment 0004-Document-the-Restore-panelization-menu-command--NEEDS-WORK.patch (raw) added

[mc-butler]

Changed by mooffie (@mooffie) on Feb 18, 2017 at 21:46 UTC (comment 3)

Notes:

• Patch 0002 introduces a new feature (fixes an omission, actually). This should fix External panelize: can browse only one of the resulting directories #3773.

Things to do:

• A cleanup patch should follow (to get rid of the "@todo" comments in patch 0001, and to get rid of cd_panelize_cmd()).

• Patch 0004 (the documentation itself) needs work.

[mc-butler]

Changed by zaytsev (@zyv) on Feb 18, 2017 at 22:22 UTC (comment 4)

Very nice.

[mc-butler]

Changed by cri (cri@….org) on Feb 22, 2017 at 20:52 UTC (comment 4.5)

Very nice.

I agree! :) Thank you very much for the explanation and for completing the feature.
I'll be glad to help with the documentation as soon as the feature is stable.

[mc-butler]

Changed by mooffie (@mooffie) on Feb 23, 2017 at 19:43 UTC (comment 5.6)

• Milestone changed from Future Releases to 4.8.20

Just to update you:

I want to document some more of the code (e.g., an undocumented "follow" feature was committed as part of #275), so this ticket will have to wait till 4.8.20 because I need to do some more investigative work. I'll probably also have to start another help page ("Panelization", or "Panelized panels").

Replying to cri:

I'll be glad to help with the documentation as soon as the feature is stable.

The feature is stable. I can certainly get help in wording the text and getting opinion if it's clear enough.

[mc-butler]

Changed by mooffie (@mooffie) on Apr 18, 2017 at 17:44 UTC (comment 7)

• Blocked by set to #2942

[mc-butler]

Changed by zaytsev (@zyv) on Nov 18, 2017 at 17:31 UTC (comment 8)

• Milestone changed from 4.8.20 to 4.8.21

[mc-butler]

Changed by zaytsev (@zyv) on May 27, 2018 at 13:15 UTC (comment 9)

• Milestone changed from 4.8.21 to 4.8.22

[mc-butler]

Changed by zaytsev (@zyv) on Dec 29, 2018 at 14:55 UTC (comment 10)

• Milestone changed from 4.8.22 to 4.8.23

[mc-butler]

Changed by zaytsev (@zyv) on Jun 16, 2019 at 17:20 UTC (comment 11)

• Milestone changed from 4.8.23 to 4.8.24

[mc-butler]

Changed by zaytsev (@zyv) on Jul 5, 2020 at 17:26 UTC (comment 12)

• Milestone changed from 4.8.25 to 4.8.26

[mc-butler]

Changed by zaytsev (@zyv) on Jan 10, 2021 at 14:19 UTC (comment 13)

• Milestone changed from 4.8.26 to 4.8.27

[mc-butler]

Changed by andrew_b (@aborodin) on Apr 8, 2021 at 6:22 UTC (comment 14)

• Milestone changed from 4.8.27 to Future Releases