Github messages for voidlinux
 help / color / mirror / Atom feed
* [PR PATCH] Add `txt2tags` and change manpages of some programs
@ 2021-07-03 15:38 meator
  2021-07-03 16:12 ` [PR PATCH] [Updated] " meator
                   ` (10 more replies)
  0 siblings, 11 replies; 12+ messages in thread
From: meator @ 2021-07-03 15:38 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 2466 bytes --]

There is a new pull request by meator against master on the void-packages repository

https://github.com/meator/void-packages txt2tags
https://github.com/void-linux/void-packages/pull/31786

Add `txt2tags` and change manpages of some programs
<!-- Mark items with [x] where applicable -->

#### General
- [x] This is a new package and it conforms to the [quality requirements](https://github.com/void-linux/void-packages/blob/master/Manual.md#quality-requirements)

#### Have the results of the proposed changes been tested?
- [x] I use the packages affected by the proposed changes on a regular basis and confirm this PR works for me
- [ ] I generally don't use the affected packages but briefly tested this PR

<!--
If GitHub CI cannot be used to validate the build result (for example, if the
build is likely to take several hours), make sure to
[skip CI](https://github.com/void-linux/void-packages/blob/master/CONTRIBUTING.md#continuous-integration).
When skipping CI, uncomment and fill out the following section.
Note: for builds that are likely to complete in less than 2 hours, it is not
acceptable to skip CI.
-->
#### Does it build and run successfully? 
(Please choose at least one native build and, if supported, at least one cross build. More are better.)
- [x] I built this PR locally for my native architecture, (x86_64-glibc)
- [x] I built this PR locally for these architectures (if supported. mark crossbuilds):
  - [ ] aarch64-musl
  - [x] armv7l
  - [ ] armv6l-musl
---
This pull request adds the `txt2tags` package, adds a manpage and a missing file to `grml-zsh-config` and removes the pre-generated manpage in `xdgmenumaker`.

The `txt2tag` package was supposed to be added, but [was rejected](https://github.com/void-linux/void-packages/pull/11960#discussion_r287600511) because it only had a python2 version at the time. There is a python3 version now, so I want to add it here. The `xdgmenumaker` package has to include a precompiled version of its manpage in `files/`, because the `txt2tags` package isn't in the repo (more info [here](https://github.com/void-linux/void-packages/pull/11960#issuecomment-496066069)). This pull request removes the premade manpage. And it adds the manpage of `grml-zsh-config`, which depends on `txt2tags`, into the package. It also adds the `etc/zsh/keephack` file to `grml-zsh-config`.

A patch file from https://github.com/void-linux/void-packages/pull/31786.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-txt2tags-31786.patch --]
[-- Type: text/x-diff, Size: 19087 bytes --]

From e4479cdba9b035975a1f1c98eb690f3a2177564f Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 15:54:21 +0200
Subject: [PATCH 1/3] New package: txt2tags-3.7

This commit adds the python3 version of txt2tags.
---
 srcpkgs/txt2tags/template | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 srcpkgs/txt2tags/template

diff --git a/srcpkgs/txt2tags/template b/srcpkgs/txt2tags/template
new file mode 100644
index 000000000000..99265d07780b
--- /dev/null
+++ b/srcpkgs/txt2tags/template
@@ -0,0 +1,13 @@
+# Template file for 'txt2tags'
+pkgname=txt2tags
+version=3.7
+revision=1
+build_style=python3-module
+hostmakedepends="python3 python3-setuptools"
+depends="python3"
+short_desc="Tool for converting plain text into many markup languages"
+maintainer="meator <coder64@protonmail.com>"
+license="GPL-2.0-or-later"
+homepage="https://txt2tags.org/"
+distfiles="https://github.com/txt2tags/txt2tags/archive/refs/tags/${version}.tar.gz"
+checksum=ba745fc1aa98996578afadeb325173f7032a40f161dc4f6f7a7aa08848d11d03

From 7a0cfe0cf1aa10f633da86055b99fa0c59e7d617 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:06:56 +0200
Subject: [PATCH 2/3] xdgmenumaker: remove pre-generated man page

The pre-generated man page is not needed anymore, because txt2tags is in the
repo. More info at https://github.com/void-linux/void-packages/pull/14645.
---
 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 | 463 ------------------
 srcpkgs/xdgmenumaker/template                 |  11 +-
 2 files changed, 8 insertions(+), 466 deletions(-)
 delete mode 100644 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1

diff --git a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 b/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
deleted file mode 100644
index 2dd5519afeac..000000000000
--- a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
+++ /dev/null
@@ -1,463 +0,0 @@
-.TH "xdgmenumaker" 1 "09/16/2018" "George Vlahavas"
-
-.SH NAME
-.P
-xdgmenumaker \- generate XDG menus
-.SH SYNOPSIS
-.P
-\fBxdgmenumaker\fR [\fIOPTIONS\fR]
-.SH DESCRIPTION
-.P
-\fBxdgmenumaker\fR is a command line tool, written in python, that
-generates application menus using XDG information, by scanning
-*.desktop files in all \fI$XDG_DATA_DIRS/applications\fR directories. All
-applications are sorted according to the main categories as specified
-by
-freedesktop.org (http://standards.freedesktop.org/menu\-spec/latest/apa.html)
-.P
-The menu entries that are generated by \fBxdgmenumaker\fR are localised
-according to the running user locale settings.
-.P
-\fBxdgmenumaker\fR currently supports generating menus for:
-
-.RS
-.IP \(bu 3
-amiwm
-.IP \(bu 3
-blackbox
-.IP \(bu 3
-compizboxmenu
-.IP \(bu 3
-fluxbox
-.IP \(bu 3
-fvwm
-.IP \(bu 3
-icewm
-.IP \(bu 3
-jwm
-.IP \(bu 3
-pekwm
-.IP \(bu 3
-twm and compatible derivatives such as ctwm and vtwm
-.IP \(bu 3
-windowmaker
-.RE
-.IP
-
-.P
-\fBxdgmenumaker\fR requires \fIPython 2.7\fR or \fI3.x\fR, \fIpygtk\fR
-(for Python 2.7) or \fIpygobject\fR and \fIgobject\-instrospection\fR
-(for Python 3.x), as well as \fIpyxdg\fR. \fIPillow\fR is an optional
-dependency (used by the \fB\-\-max\-icon\-size\fR option).
-.SH OPTIONS
-
-.TP
-\fB\-f, \-\-format\fR
-specify the output format to use. Valid options are \fIamiwm\fR, \fIblackbox\fR,
-\fIcompizboxmenu\fR, \fIfluxbox\fR, \fIfvwm\fR, \fIicewm\fR, \fIjwm\fR, \fIpekwm\fR,
-\fItwm\fR and \fIwindowmaker\fR.
-Specifying the output format is mandatory.
-
-.TP
-\fB\-i, \-\-icons\fR
-enable support for icons in the menus. This option does not have any
-effect for \fIamiwm\fR, \fIblackbox\fR or \fIwindowmaker\fR menus.
-
-.TP
-\fB\-s, \-\-size\fR
-set the preferred icon size in pixels. The default size is 16. You can
-set this to any number, but it generally makes sense to use standard
-icons sizes, like 16, 22, 24, 32 etc. Obviously this has an effect only
-if the \fI\-\-icons\fR option is used. You have to be careful with the sizes
-you use; some window managers don't support large icons in the menu.
-
-.TP
-\fB\-n, \-\-no\-submenu\fR
-do not create a submenu. Instead, place the application categories menus
-in the window manager's main menu. This option does not have any effect
-for \fIwindowmaker\fR menus.
-
-.TP
-\fB\-\-max\-icon\-size\fR
-restrict the maximum size for icons to the one specified with the
-\fI\-\-size\fR option. Any icons that are larger than the specified size
-will get discarded and will not be used.
-
-.TP
-\fB\-\-no\-svg\fR
-do not use SVG icons even for the WMs that support it. Right now that
-is only JWM.
-
-.TP
-\fB\-\-pekwm\-dynamic\fR
-create dynamic menus for pekwm. If you want to have dynamically
-generated menus for pekwm you have to use this option. Do not use it if
-you want to generate static menus for pekwm. Only works with \fIpekwm\fR
-of course.
-
-.TP
-\fB\-\-twm\-titles\fR
-display menu titles in TWM menus. Naturally, only has an effect when
-used with \fItwm\fR.
-
-.SH GENERAL OPTIONS
-
-.TP
-\fB\-h\fR
-Prints a usage message briefly summarizing all command\-line options
-and exits.
-
-.SH CONFIGURATION
-.P
-The terminal emulator to be used for menu entries that state that an
-application must be launched inside a terminal, can be specified in a
-\fI~/.config/xdgmenumaker.cfg\fR configuration file. Here's an example
-specifying \fBrxvt\fR as the default terminal emulator:
-
-.nf
-[Terminal]
-terminal = rxvt
-.fi
-
-
-.P
-If no such file is present, or if no terminal is set within the file,
-xdgmenumaker will default to the one specified in the debian
-alternatives system on debian and debian\-like systems and to xterm in
-any other case.
-.P
-Setting the path to a terminal emulator in an \fIXDGMENUMAKERTERM\fR
-environment variable will override any other setting.
-.SH USAGE
-
-.TP
-\fBAmiWM\fR
-
-You can generate a menu for AmiWM, running xdgmenumaker like this:
-
-$ xdgmenumaker \-f amiwm > ~/.amiwm\-xdgmenu
-
-As AmiWM does not support including other files in its settings file,
-you'll have to copy the contents of the created file in your
-\fI~/.amiwmrc\fR. It should be possible to create a script that would
-generate the main \fI~/.amiwmrc\fR file from different "source" files, but
-I'll leave that as an exercise to the user.
-
-.TP
-\fBBlackbox\fR
-
-To generate an application menu for Blackbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu
-
-and then change your main Blackbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.blackbox/menu\fR file:
-
-[include] (~/.blackbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Blackbox Menu) {xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu}
-
-.TP
-\fBCompiz Boxmenu\fR
-
-There are two ways to have an xdg menu in compiz\-boxmenu. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and add a block of code like this inside the root \fI<menu>\fR element:
-
-.nf
-<item type="launcher">
-  <command mode2="pipe">xdgmenumaker -nif compizboxmenu</command>
-  <icon>applications-other</icon>
-  <name>Applications</name>
-</item>
-.fi
-
-
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-dropdown for new menu files or menu items. Select launcher to create a
-new launcher. Set the name of the launcher to whatever you want. This will
-be the display name for the pipe menu. Then enter in:
-
-xdgmenumaker \-nif compizboxmenu
-
-for the command entry. Click the combobox
-next to the command text box and switch that to "Pipe".
-
-\fBStatic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and paste the output of:
-
-$ xdgmenumaker \-if compizboxmenu
-
-into \fI~/.config/compiz/boxmenu/menu.xml\fR.
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-button that says \fIGenerate menu entries from a pipemenu script\fR. In the dialog
-box that pops up, type in:
-
-xdgmenumaker \-if compizboxmenu
-
-to append the statically generated menu to any menu file you want.
-
-.TP
-\fBFluxbox\fR
-
-To generate an application menu for Fluxbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu
-
-and then change your main Fluxbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.fluxbox/menu\fR file:
-
-[include] (~/.fluxbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Fluxbox Menu) {xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu}
-
-.TP
-\fBFvwm\fR
-
-To generate an application menu for Fvwm, you can run \fBxdgmenumaker\fR
-like this:
-
-$ xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and then edit your main Fvwm configuration file and add a line to read
-that file:
-
-read xdgmenu
-
-and also include it somewhere in your main menu, for example:
-
-.nf
-AddToMenu MenuFvwmRoot  "Root Menu"             Title
-+                       "Applications"          Popup xdgmenu
-.fi
-
-
-You could also put the menus for individual categories in your main menu
-if you want. Just look in the ~/.fvwm/xdgmenu file for the category
-names.
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it:
-
-+ "Update Fvwm Menu" Exec xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and restart Fvwm to apply the changes.
-
-\fINOTE:\fR If you're going to use the \fI\-\-icons\fR option to include icons
-in your menus, you might consider using the \fI\-\-max\-icon\-size\fR
-option too. Fvwm does not resize icons in its menu and having entries
-with icons that are too big makes for funny looking menus.
-
-.TP
-\fBIceWM\fR
-
-To generate an application menu for IceWM, run \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f icewm > ~/.icewm/appmenu
-
-or if you want icons in your menu:
-
-$ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-and you can then edit your \fI~/.icewm/menu\fR file and add this line
-somewhere:
-
-include appmenu
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu, if
-you want to update it, without having to run the command manually again:
-
-prog "Update Menu" _none_ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-\fINOTE:\fR If you don't request icons in the menu, or if an icon is not found
-for a certain app, the icon name in the menu for that app is set to
-"_none_". This doesn't actually set the icon for that app to none.
-IceWM menu entries should always include an icon . So, by pointing it
-to a non existing icon, you essentially set it to use no icon. If you
-actually have an icewm icon named "_none_", that one will be used instead.
-
-.TP
-\fBJWM\fR
-
-You can edit your \fI~/.jwmrc\fR file and add a line that generates the
-applications menu, like this:
-
-<Include>exec: xdgmenumaker \-n \-i \-f jwm</Include>
-
-You need to put that line somewhere in the \fIRootMenu\fR section of the
-\fI~/.jwmrc\fR file.
-
-You can update the menu with:
-
-$ jwm \-reload
-
-Or you can restart JWM and the updated menu should appear. The menu will be
-recreated every time JWM is started, restarted, or when the menu is
-reloaded with the above command. You can even add a menu item that will
-refresh the menu, like this:
-
-<Program label="Refresh Menu">jwm \-reload</Program>
-
-.TP
-\fBpekwm\fR
-
-There are two ways to have an XDG menu in pekwm. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.pekwm/menu\fR file with your favourite text editor and add
-a line like the following one in the location that you want the
-dynamically generated menu to appear:
-
-.nf
-Entry = "" { Actions = "Dynamic /usr/bin/xdgmenumaker -n -i -f pekwm --pekwm-dynamic" }
-.fi
-
-
-
-Restart pekwm and the generated menu should appear. The menu will be
-automatically generated every time you access it, so it will always be
-up to date. But since xdgmenumaker will run every time you access the
-menu, the menu might not appear instantly, especially if you are using
-an older PC.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-n \-i \-f pekwm > ~/.pekwm/appsmenu
-
-to create a file with the menu contents. Then edit your
-\fI~/.pekwm/menu\fR file to include that menu, by adding a line like the
-following, in the location that you want the menu to appear:
-
-INCLUDE = "/home/your_user_name/.pekwm/appsmenu"
-
-Restart pekwm and the generated menu should appear. The menu is static
-and if you add/remove any applications, you will have to run the
-xdgmenumaker command and restart pekwm all over again to update it. The
-advantage is that there will be no delay in displaying the menu.
-
-.TP
-\fBTWM and Derivatives\fR
-
-You can create a menu for TWM running \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f twm > ~/.twm\-xdgmenu
-
-If you're using the standard TWM, then unfortunately you'll have to
-manually copy/paste the contents of the generated \fI~/.twm\-xdgmenu\fR file
-into your \fI~/.twmrc\fR manually. You could then add something like this
-to your main menu definition:
-
-.nf
-"Applications" f.menu "xdgmenu"
-.fi
-
-
-
-It could be possible to create a script that updates the menus inside
-the main \fI~/.twmrc\fR settings file, but I'll leave that as an exercise
-for the user.
-
-If you're using CTWM or VTWM, instead of manually copy/pasting the menu
-contents into your settings file, you could just add an include line
-like this:
-
-.nf
-sinclude(`/home/george/.twm-xdgmenu')
-.fi
-
-
-
-\fINote:\fR In order for this to work with VTWM, \fBvtwm\fR has to be called
-with the \fI\-m\fR switch.
-
-.TP
-\fBWindowMaker\fR
-
-There are two ways to have an XDG menu in WindowMaker. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBxdgmenumaker\fR uses utf8 encoding and localised strings by default
-and has been tested only with wmaker\-crm>=0.95.1. No idea if utf8 works
-properly with older WindowMaker versions.
-
-\fBDynamic Menus\fR
-
-Open the WindowMaker preferences tool. In the \fIApplication Menu Definition\fR
-section, add a \fIGenerated Submenu\fR in your menu, by dragging it
-in. Click on the menu item you just dragged in and in the preferences
-window, in \fICommand\fR, add:
-
-xdgmenumaker \-f windowmaker
-
-Save and close the preferences window.
-
-That command will be run every time you access that submenu, so the
-application list in there will be always up to date. The downside is
-that with running this command every time, especially if
-you are on a very old PC, it might slow things down a bit. Even then it
-is probably not anything considerable.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-f windowmaker > ~/GNUstep/Defaults/xdg_menu
-
-Then open the WindowMaker preferences tool and in the
-\fIApplication Menu Definition\fR section, add an
-\fIExternal Submenu\fR by dragging it in your menu.
-Click on the menu item you just dragged in and in the preferences
-window, in \fIPath for Menu\fR, add the location of the menu file you just
-created:
-
-~/GNUstep/Defaults/xdg_menu
-
-You can add the above mentioned \fBxdgmenumaker\fR command as another
-item in your menu, if you want to update it, without having to run the
-command manually again.
-In the \fIApplication Menu Definition\fR section in the WindowMaker
-preferences window, add a \fIRun Program\fR item in your menu by dragging it
-your menu. Click on the menu item you just dragged in and in the
-preferences window, in \fIProgram to Run\fR, add the \fBxdgmenumaker\fR command as
-mentioned above.
-
-The downside of this method, is that the menu contents will not be
-updated when you install a new application or remove one. You will need
-to run the xdgmenumaker command every time you want the menu to be
-updated. The upside is that the menu will not be generated every time
-you access the menu. This might be a better choice for (really) older
-hardware.
-
-.SH WEBSITE
-.P
-https://github.com/gapan/xdgmenumaker
-.SH AUTHORS
-.P
-\fBxdgmenumaker\fR was written by George Vlahavas <vlahavas~at~gmail~dot~com>
-
-.\" man code generated by txt2tags 2.6. (http://txt2tags.org)
diff --git a/srcpkgs/xdgmenumaker/template b/srcpkgs/xdgmenumaker/template
index a71ccd9b3759..7dd2087bf7df 100644
--- a/srcpkgs/xdgmenumaker/template
+++ b/srcpkgs/xdgmenumaker/template
@@ -1,8 +1,9 @@
 # Template file for 'xdgmenumaker'
 pkgname=xdgmenumaker
 version=1.6
-revision=1
+revision=2
 build_style=gnu-makefile
+hostmakedepends="txt2tags"
 depends="python3-xdg python3-gobject gobject-introspection python3-Pillow"
 short_desc="Automatic menu generator for WMs, such as, fluxbox, icewm, jwm, pekwm"
 maintainer="reback00 <reback00@protonmail.com>"
@@ -12,9 +13,13 @@ distfiles="https://github.com/gapan/${pkgname}/archive/${version}.tar.gz"
 checksum=46192e7e4e25b024c0516d83e8fc2c503dd1ac8e5f8c1998d3e9e4b3cbf8919b
 python_version=3
 
+pre_build() {
+	txt2tags --target man man/xdgmenumaker.t2t
+}
+
 pre_install() {
-	# Install pre-generated man page
-	vman ${FILESDIR}/${version}/xdgmenumaker.1
+	# Install generated man page
+	vman man/xdgmenumaker.1
 	# Install README.md as documentation
 	vdoc README.md
 }

From db97f2fd69b8b0b02d1ebde9a66c12414f803c48 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:14:32 +0200
Subject: [PATCH 3/3] grml-zsh-config: add manpage and a missing file

This commit generates the grmlzshrc(5) man page via txt2tags and adds
it to the package and adds the etc/zsh/keephack file  into the
package.
---
 srcpkgs/grml-zsh-config/template | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/srcpkgs/grml-zsh-config/template b/srcpkgs/grml-zsh-config/template
index 50efbb7d5abb..8e0199b292c6 100644
--- a/srcpkgs/grml-zsh-config/template
+++ b/srcpkgs/grml-zsh-config/template
@@ -1,8 +1,9 @@
 # Template file for 'grml-zsh-config'
 pkgname=grml-zsh-config
 version=0.18.0
-revision=1
+revision=2
 wrksrc="grml-etc-core-${version}"
+hostmakedepends="make txt2tags"
 short_desc="Grml's zsh setup"
 maintainer="Christian Poulwey <christian.poulwey@t-online.de>"
 license="GPL-2.0-only"
@@ -10,7 +11,13 @@ homepage="https://grml.org/zsh/"
 distfiles="https://deb.grml.org/pool/main/g/grml-etc-core/grml-etc-core_${version}.tar.gz"
 checksum=81bce54ac1cde04d426182b72ffa9077b26f80bcceca4cb9580de4e031a5088f
 
+pre_build() {
+	make -C doc/ grmlzshrc.5
+}
+
 do_install() {
 	vinstall etc/skel/.zshrc 0644 etc/skel
 	vinstall etc/zsh/zshrc 0644 etc/zsh
+	vinstall etc/zsh/keephack 0644 etc/zsh
+	vman doc/grmlzshrc.5
 }

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PR PATCH] [Updated] Add `txt2tags` and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
@ 2021-07-03 16:12 ` meator
  2021-07-03 16:33 ` meator
                   ` (9 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-03 16:12 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 2471 bytes --]

There is an updated pull request by meator against master on the void-packages repository

https://github.com/meator/void-packages txt2tags
https://github.com/void-linux/void-packages/pull/31786

Add `txt2tags` and change manpages of some programs
<!-- Mark items with [x] where applicable -->

#### General
- [x] This is a new package and it conforms to the [quality requirements](https://github.com/void-linux/void-packages/blob/master/Manual.md#quality-requirements)

#### Have the results of the proposed changes been tested?
- [x] I use the packages affected by the proposed changes on a regular basis and confirm this PR works for me
- [ ] I generally don't use the affected packages but briefly tested this PR

<!--
If GitHub CI cannot be used to validate the build result (for example, if the
build is likely to take several hours), make sure to
[skip CI](https://github.com/void-linux/void-packages/blob/master/CONTRIBUTING.md#continuous-integration).
When skipping CI, uncomment and fill out the following section.
Note: for builds that are likely to complete in less than 2 hours, it is not
acceptable to skip CI.
-->
#### Does it build and run successfully? 
(Please choose at least one native build and, if supported, at least one cross build. More are better.)
- [x] I built this PR locally for my native architecture, (x86_64-glibc)
- [x] I built this PR locally for these architectures (if supported. mark crossbuilds):
  - [ ] aarch64-musl
  - [x] armv7l
  - [ ] armv6l-musl
---
This pull request adds the `txt2tags` package, adds a manpage and a missing file to `grml-zsh-config` and removes the pre-generated manpage in `xdgmenumaker`.

The `txt2tag` package was supposed to be added, but [was rejected](https://github.com/void-linux/void-packages/pull/11960#discussion_r287600511) because it only had a python2 version at the time. There is a python3 version now, so I want to add it here. The `xdgmenumaker` package has to include a precompiled version of its manpage in `files/`, because the `txt2tags` package isn't in the repo (more info [here](https://github.com/void-linux/void-packages/pull/11960#issuecomment-496066069)). This pull request removes the premade manpage. And it adds the manpage of `grml-zsh-config`, which depends on `txt2tags`, into the package. It also adds the `etc/zsh/keephack` file to `grml-zsh-config`.

A patch file from https://github.com/void-linux/void-packages/pull/31786.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-txt2tags-31786.patch --]
[-- Type: text/x-diff, Size: 19137 bytes --]

From 60a4a7a2422cd71203a57b0bb4267de7cf95cd07 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 15:54:21 +0200
Subject: [PATCH 1/3] New package: txt2tags-3.7

This commit adds the python3 version of txt2tags.
---
 srcpkgs/txt2tags/template | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 srcpkgs/txt2tags/template

diff --git a/srcpkgs/txt2tags/template b/srcpkgs/txt2tags/template
new file mode 100644
index 000000000000..dd71d0261b7e
--- /dev/null
+++ b/srcpkgs/txt2tags/template
@@ -0,0 +1,18 @@
+# Template file for 'txt2tags'
+pkgname=txt2tags
+version=3.7
+revision=1
+build_style=python3-module
+hostmakedepends="python3 python3-setuptools"
+depends="python3"
+checkdepends="tox"
+short_desc="Tool for converting plain text into many markup languages"
+maintainer="meator <coder64@protonmail.com>"
+license="GPL-2.0-or-later"
+homepage="https://txt2tags.org/"
+distfiles="https://github.com/txt2tags/txt2tags/archive/refs/tags/${version}.tar.gz"
+checksum=ba745fc1aa98996578afadeb325173f7032a40f161dc4f6f7a7aa08848d11d03
+
+do_check() {
+	tox
+}

From 462a840b74e32601d5f775933879a196f6379a44 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:06:56 +0200
Subject: [PATCH 2/3] xdgmenumaker: remove pre-generated man page

The pre-generated man page is not needed anymore, because txt2tags is in the
repo. More info at https://github.com/void-linux/void-packages/pull/14645.
---
 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 | 463 ------------------
 srcpkgs/xdgmenumaker/template                 |  11 +-
 2 files changed, 8 insertions(+), 466 deletions(-)
 delete mode 100644 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1

diff --git a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 b/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
deleted file mode 100644
index 2dd5519afeac..000000000000
--- a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
+++ /dev/null
@@ -1,463 +0,0 @@
-.TH "xdgmenumaker" 1 "09/16/2018" "George Vlahavas"
-
-.SH NAME
-.P
-xdgmenumaker \- generate XDG menus
-.SH SYNOPSIS
-.P
-\fBxdgmenumaker\fR [\fIOPTIONS\fR]
-.SH DESCRIPTION
-.P
-\fBxdgmenumaker\fR is a command line tool, written in python, that
-generates application menus using XDG information, by scanning
-*.desktop files in all \fI$XDG_DATA_DIRS/applications\fR directories. All
-applications are sorted according to the main categories as specified
-by
-freedesktop.org (http://standards.freedesktop.org/menu\-spec/latest/apa.html)
-.P
-The menu entries that are generated by \fBxdgmenumaker\fR are localised
-according to the running user locale settings.
-.P
-\fBxdgmenumaker\fR currently supports generating menus for:
-
-.RS
-.IP \(bu 3
-amiwm
-.IP \(bu 3
-blackbox
-.IP \(bu 3
-compizboxmenu
-.IP \(bu 3
-fluxbox
-.IP \(bu 3
-fvwm
-.IP \(bu 3
-icewm
-.IP \(bu 3
-jwm
-.IP \(bu 3
-pekwm
-.IP \(bu 3
-twm and compatible derivatives such as ctwm and vtwm
-.IP \(bu 3
-windowmaker
-.RE
-.IP
-
-.P
-\fBxdgmenumaker\fR requires \fIPython 2.7\fR or \fI3.x\fR, \fIpygtk\fR
-(for Python 2.7) or \fIpygobject\fR and \fIgobject\-instrospection\fR
-(for Python 3.x), as well as \fIpyxdg\fR. \fIPillow\fR is an optional
-dependency (used by the \fB\-\-max\-icon\-size\fR option).
-.SH OPTIONS
-
-.TP
-\fB\-f, \-\-format\fR
-specify the output format to use. Valid options are \fIamiwm\fR, \fIblackbox\fR,
-\fIcompizboxmenu\fR, \fIfluxbox\fR, \fIfvwm\fR, \fIicewm\fR, \fIjwm\fR, \fIpekwm\fR,
-\fItwm\fR and \fIwindowmaker\fR.
-Specifying the output format is mandatory.
-
-.TP
-\fB\-i, \-\-icons\fR
-enable support for icons in the menus. This option does not have any
-effect for \fIamiwm\fR, \fIblackbox\fR or \fIwindowmaker\fR menus.
-
-.TP
-\fB\-s, \-\-size\fR
-set the preferred icon size in pixels. The default size is 16. You can
-set this to any number, but it generally makes sense to use standard
-icons sizes, like 16, 22, 24, 32 etc. Obviously this has an effect only
-if the \fI\-\-icons\fR option is used. You have to be careful with the sizes
-you use; some window managers don't support large icons in the menu.
-
-.TP
-\fB\-n, \-\-no\-submenu\fR
-do not create a submenu. Instead, place the application categories menus
-in the window manager's main menu. This option does not have any effect
-for \fIwindowmaker\fR menus.
-
-.TP
-\fB\-\-max\-icon\-size\fR
-restrict the maximum size for icons to the one specified with the
-\fI\-\-size\fR option. Any icons that are larger than the specified size
-will get discarded and will not be used.
-
-.TP
-\fB\-\-no\-svg\fR
-do not use SVG icons even for the WMs that support it. Right now that
-is only JWM.
-
-.TP
-\fB\-\-pekwm\-dynamic\fR
-create dynamic menus for pekwm. If you want to have dynamically
-generated menus for pekwm you have to use this option. Do not use it if
-you want to generate static menus for pekwm. Only works with \fIpekwm\fR
-of course.
-
-.TP
-\fB\-\-twm\-titles\fR
-display menu titles in TWM menus. Naturally, only has an effect when
-used with \fItwm\fR.
-
-.SH GENERAL OPTIONS
-
-.TP
-\fB\-h\fR
-Prints a usage message briefly summarizing all command\-line options
-and exits.
-
-.SH CONFIGURATION
-.P
-The terminal emulator to be used for menu entries that state that an
-application must be launched inside a terminal, can be specified in a
-\fI~/.config/xdgmenumaker.cfg\fR configuration file. Here's an example
-specifying \fBrxvt\fR as the default terminal emulator:
-
-.nf
-[Terminal]
-terminal = rxvt
-.fi
-
-
-.P
-If no such file is present, or if no terminal is set within the file,
-xdgmenumaker will default to the one specified in the debian
-alternatives system on debian and debian\-like systems and to xterm in
-any other case.
-.P
-Setting the path to a terminal emulator in an \fIXDGMENUMAKERTERM\fR
-environment variable will override any other setting.
-.SH USAGE
-
-.TP
-\fBAmiWM\fR
-
-You can generate a menu for AmiWM, running xdgmenumaker like this:
-
-$ xdgmenumaker \-f amiwm > ~/.amiwm\-xdgmenu
-
-As AmiWM does not support including other files in its settings file,
-you'll have to copy the contents of the created file in your
-\fI~/.amiwmrc\fR. It should be possible to create a script that would
-generate the main \fI~/.amiwmrc\fR file from different "source" files, but
-I'll leave that as an exercise to the user.
-
-.TP
-\fBBlackbox\fR
-
-To generate an application menu for Blackbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu
-
-and then change your main Blackbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.blackbox/menu\fR file:
-
-[include] (~/.blackbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Blackbox Menu) {xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu}
-
-.TP
-\fBCompiz Boxmenu\fR
-
-There are two ways to have an xdg menu in compiz\-boxmenu. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and add a block of code like this inside the root \fI<menu>\fR element:
-
-.nf
-<item type="launcher">
-  <command mode2="pipe">xdgmenumaker -nif compizboxmenu</command>
-  <icon>applications-other</icon>
-  <name>Applications</name>
-</item>
-.fi
-
-
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-dropdown for new menu files or menu items. Select launcher to create a
-new launcher. Set the name of the launcher to whatever you want. This will
-be the display name for the pipe menu. Then enter in:
-
-xdgmenumaker \-nif compizboxmenu
-
-for the command entry. Click the combobox
-next to the command text box and switch that to "Pipe".
-
-\fBStatic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and paste the output of:
-
-$ xdgmenumaker \-if compizboxmenu
-
-into \fI~/.config/compiz/boxmenu/menu.xml\fR.
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-button that says \fIGenerate menu entries from a pipemenu script\fR. In the dialog
-box that pops up, type in:
-
-xdgmenumaker \-if compizboxmenu
-
-to append the statically generated menu to any menu file you want.
-
-.TP
-\fBFluxbox\fR
-
-To generate an application menu for Fluxbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu
-
-and then change your main Fluxbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.fluxbox/menu\fR file:
-
-[include] (~/.fluxbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Fluxbox Menu) {xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu}
-
-.TP
-\fBFvwm\fR
-
-To generate an application menu for Fvwm, you can run \fBxdgmenumaker\fR
-like this:
-
-$ xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and then edit your main Fvwm configuration file and add a line to read
-that file:
-
-read xdgmenu
-
-and also include it somewhere in your main menu, for example:
-
-.nf
-AddToMenu MenuFvwmRoot  "Root Menu"             Title
-+                       "Applications"          Popup xdgmenu
-.fi
-
-
-You could also put the menus for individual categories in your main menu
-if you want. Just look in the ~/.fvwm/xdgmenu file for the category
-names.
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it:
-
-+ "Update Fvwm Menu" Exec xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and restart Fvwm to apply the changes.
-
-\fINOTE:\fR If you're going to use the \fI\-\-icons\fR option to include icons
-in your menus, you might consider using the \fI\-\-max\-icon\-size\fR
-option too. Fvwm does not resize icons in its menu and having entries
-with icons that are too big makes for funny looking menus.
-
-.TP
-\fBIceWM\fR
-
-To generate an application menu for IceWM, run \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f icewm > ~/.icewm/appmenu
-
-or if you want icons in your menu:
-
-$ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-and you can then edit your \fI~/.icewm/menu\fR file and add this line
-somewhere:
-
-include appmenu
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu, if
-you want to update it, without having to run the command manually again:
-
-prog "Update Menu" _none_ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-\fINOTE:\fR If you don't request icons in the menu, or if an icon is not found
-for a certain app, the icon name in the menu for that app is set to
-"_none_". This doesn't actually set the icon for that app to none.
-IceWM menu entries should always include an icon . So, by pointing it
-to a non existing icon, you essentially set it to use no icon. If you
-actually have an icewm icon named "_none_", that one will be used instead.
-
-.TP
-\fBJWM\fR
-
-You can edit your \fI~/.jwmrc\fR file and add a line that generates the
-applications menu, like this:
-
-<Include>exec: xdgmenumaker \-n \-i \-f jwm</Include>
-
-You need to put that line somewhere in the \fIRootMenu\fR section of the
-\fI~/.jwmrc\fR file.
-
-You can update the menu with:
-
-$ jwm \-reload
-
-Or you can restart JWM and the updated menu should appear. The menu will be
-recreated every time JWM is started, restarted, or when the menu is
-reloaded with the above command. You can even add a menu item that will
-refresh the menu, like this:
-
-<Program label="Refresh Menu">jwm \-reload</Program>
-
-.TP
-\fBpekwm\fR
-
-There are two ways to have an XDG menu in pekwm. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.pekwm/menu\fR file with your favourite text editor and add
-a line like the following one in the location that you want the
-dynamically generated menu to appear:
-
-.nf
-Entry = "" { Actions = "Dynamic /usr/bin/xdgmenumaker -n -i -f pekwm --pekwm-dynamic" }
-.fi
-
-
-
-Restart pekwm and the generated menu should appear. The menu will be
-automatically generated every time you access it, so it will always be
-up to date. But since xdgmenumaker will run every time you access the
-menu, the menu might not appear instantly, especially if you are using
-an older PC.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-n \-i \-f pekwm > ~/.pekwm/appsmenu
-
-to create a file with the menu contents. Then edit your
-\fI~/.pekwm/menu\fR file to include that menu, by adding a line like the
-following, in the location that you want the menu to appear:
-
-INCLUDE = "/home/your_user_name/.pekwm/appsmenu"
-
-Restart pekwm and the generated menu should appear. The menu is static
-and if you add/remove any applications, you will have to run the
-xdgmenumaker command and restart pekwm all over again to update it. The
-advantage is that there will be no delay in displaying the menu.
-
-.TP
-\fBTWM and Derivatives\fR
-
-You can create a menu for TWM running \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f twm > ~/.twm\-xdgmenu
-
-If you're using the standard TWM, then unfortunately you'll have to
-manually copy/paste the contents of the generated \fI~/.twm\-xdgmenu\fR file
-into your \fI~/.twmrc\fR manually. You could then add something like this
-to your main menu definition:
-
-.nf
-"Applications" f.menu "xdgmenu"
-.fi
-
-
-
-It could be possible to create a script that updates the menus inside
-the main \fI~/.twmrc\fR settings file, but I'll leave that as an exercise
-for the user.
-
-If you're using CTWM or VTWM, instead of manually copy/pasting the menu
-contents into your settings file, you could just add an include line
-like this:
-
-.nf
-sinclude(`/home/george/.twm-xdgmenu')
-.fi
-
-
-
-\fINote:\fR In order for this to work with VTWM, \fBvtwm\fR has to be called
-with the \fI\-m\fR switch.
-
-.TP
-\fBWindowMaker\fR
-
-There are two ways to have an XDG menu in WindowMaker. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBxdgmenumaker\fR uses utf8 encoding and localised strings by default
-and has been tested only with wmaker\-crm>=0.95.1. No idea if utf8 works
-properly with older WindowMaker versions.
-
-\fBDynamic Menus\fR
-
-Open the WindowMaker preferences tool. In the \fIApplication Menu Definition\fR
-section, add a \fIGenerated Submenu\fR in your menu, by dragging it
-in. Click on the menu item you just dragged in and in the preferences
-window, in \fICommand\fR, add:
-
-xdgmenumaker \-f windowmaker
-
-Save and close the preferences window.
-
-That command will be run every time you access that submenu, so the
-application list in there will be always up to date. The downside is
-that with running this command every time, especially if
-you are on a very old PC, it might slow things down a bit. Even then it
-is probably not anything considerable.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-f windowmaker > ~/GNUstep/Defaults/xdg_menu
-
-Then open the WindowMaker preferences tool and in the
-\fIApplication Menu Definition\fR section, add an
-\fIExternal Submenu\fR by dragging it in your menu.
-Click on the menu item you just dragged in and in the preferences
-window, in \fIPath for Menu\fR, add the location of the menu file you just
-created:
-
-~/GNUstep/Defaults/xdg_menu
-
-You can add the above mentioned \fBxdgmenumaker\fR command as another
-item in your menu, if you want to update it, without having to run the
-command manually again.
-In the \fIApplication Menu Definition\fR section in the WindowMaker
-preferences window, add a \fIRun Program\fR item in your menu by dragging it
-your menu. Click on the menu item you just dragged in and in the
-preferences window, in \fIProgram to Run\fR, add the \fBxdgmenumaker\fR command as
-mentioned above.
-
-The downside of this method, is that the menu contents will not be
-updated when you install a new application or remove one. You will need
-to run the xdgmenumaker command every time you want the menu to be
-updated. The upside is that the menu will not be generated every time
-you access the menu. This might be a better choice for (really) older
-hardware.
-
-.SH WEBSITE
-.P
-https://github.com/gapan/xdgmenumaker
-.SH AUTHORS
-.P
-\fBxdgmenumaker\fR was written by George Vlahavas <vlahavas~at~gmail~dot~com>
-
-.\" man code generated by txt2tags 2.6. (http://txt2tags.org)
diff --git a/srcpkgs/xdgmenumaker/template b/srcpkgs/xdgmenumaker/template
index a71ccd9b3759..7dd2087bf7df 100644
--- a/srcpkgs/xdgmenumaker/template
+++ b/srcpkgs/xdgmenumaker/template
@@ -1,8 +1,9 @@
 # Template file for 'xdgmenumaker'
 pkgname=xdgmenumaker
 version=1.6
-revision=1
+revision=2
 build_style=gnu-makefile
+hostmakedepends="txt2tags"
 depends="python3-xdg python3-gobject gobject-introspection python3-Pillow"
 short_desc="Automatic menu generator for WMs, such as, fluxbox, icewm, jwm, pekwm"
 maintainer="reback00 <reback00@protonmail.com>"
@@ -12,9 +13,13 @@ distfiles="https://github.com/gapan/${pkgname}/archive/${version}.tar.gz"
 checksum=46192e7e4e25b024c0516d83e8fc2c503dd1ac8e5f8c1998d3e9e4b3cbf8919b
 python_version=3
 
+pre_build() {
+	txt2tags --target man man/xdgmenumaker.t2t
+}
+
 pre_install() {
-	# Install pre-generated man page
-	vman ${FILESDIR}/${version}/xdgmenumaker.1
+	# Install generated man page
+	vman man/xdgmenumaker.1
 	# Install README.md as documentation
 	vdoc README.md
 }

From 02a7d4ca67b530fbc9049974a4de7c46d6d506f1 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:14:32 +0200
Subject: [PATCH 3/3] grml-zsh-config: add manpage and a missing file

This commit generates the grmlzshrc(5) man page via txt2tags and adds
it to the package and adds the etc/zsh/keephack file  into the
package.
---
 srcpkgs/grml-zsh-config/template | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/srcpkgs/grml-zsh-config/template b/srcpkgs/grml-zsh-config/template
index 50efbb7d5abb..8e0199b292c6 100644
--- a/srcpkgs/grml-zsh-config/template
+++ b/srcpkgs/grml-zsh-config/template
@@ -1,8 +1,9 @@
 # Template file for 'grml-zsh-config'
 pkgname=grml-zsh-config
 version=0.18.0
-revision=1
+revision=2
 wrksrc="grml-etc-core-${version}"
+hostmakedepends="make txt2tags"
 short_desc="Grml's zsh setup"
 maintainer="Christian Poulwey <christian.poulwey@t-online.de>"
 license="GPL-2.0-only"
@@ -10,7 +11,13 @@ homepage="https://grml.org/zsh/"
 distfiles="https://deb.grml.org/pool/main/g/grml-etc-core/grml-etc-core_${version}.tar.gz"
 checksum=81bce54ac1cde04d426182b72ffa9077b26f80bcceca4cb9580de4e031a5088f
 
+pre_build() {
+	make -C doc/ grmlzshrc.5
+}
+
 do_install() {
 	vinstall etc/skel/.zshrc 0644 etc/skel
 	vinstall etc/zsh/zshrc 0644 etc/zsh
+	vinstall etc/zsh/keephack 0644 etc/zsh
+	vman doc/grmlzshrc.5
 }

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: Add `txt2tags` and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
  2021-07-03 16:12 ` [PR PATCH] [Updated] " meator
@ 2021-07-03 16:33 ` meator
  2021-07-03 17:30 ` [PR PATCH] [Updated] " meator
                   ` (8 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-03 16:33 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 324 bytes --]

New comment by meator on void-packages repository

https://github.com/void-linux/void-packages/pull/31786#issuecomment-873434006

Comment:
I have no idea why the x86_64-musl check fails. The package builds successfully, the `do_check` is the problem. I can not do the check locally in crossbuild. I will look into it later.

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PR PATCH] [Updated] Add `txt2tags` and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
  2021-07-03 16:12 ` [PR PATCH] [Updated] " meator
  2021-07-03 16:33 ` meator
@ 2021-07-03 17:30 ` meator
  2021-07-03 17:45 ` Add txt2tags " meator
                   ` (7 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-03 17:30 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 2471 bytes --]

There is an updated pull request by meator against master on the void-packages repository

https://github.com/meator/void-packages txt2tags
https://github.com/void-linux/void-packages/pull/31786

Add `txt2tags` and change manpages of some programs
<!-- Mark items with [x] where applicable -->

#### General
- [x] This is a new package and it conforms to the [quality requirements](https://github.com/void-linux/void-packages/blob/master/Manual.md#quality-requirements)

#### Have the results of the proposed changes been tested?
- [x] I use the packages affected by the proposed changes on a regular basis and confirm this PR works for me
- [ ] I generally don't use the affected packages but briefly tested this PR

<!--
If GitHub CI cannot be used to validate the build result (for example, if the
build is likely to take several hours), make sure to
[skip CI](https://github.com/void-linux/void-packages/blob/master/CONTRIBUTING.md#continuous-integration).
When skipping CI, uncomment and fill out the following section.
Note: for builds that are likely to complete in less than 2 hours, it is not
acceptable to skip CI.
-->
#### Does it build and run successfully? 
(Please choose at least one native build and, if supported, at least one cross build. More are better.)
- [x] I built this PR locally for my native architecture, (x86_64-glibc)
- [x] I built this PR locally for these architectures (if supported. mark crossbuilds):
  - [ ] aarch64-musl
  - [x] armv7l
  - [ ] armv6l-musl
---
This pull request adds the `txt2tags` package, adds a manpage and a missing file to `grml-zsh-config` and removes the pre-generated manpage in `xdgmenumaker`.

The `txt2tag` package was supposed to be added, but [was rejected](https://github.com/void-linux/void-packages/pull/11960#discussion_r287600511) because it only had a python2 version at the time. There is a python3 version now, so I want to add it here. The `xdgmenumaker` package has to include a precompiled version of its manpage in `files/`, because the `txt2tags` package isn't in the repo (more info [here](https://github.com/void-linux/void-packages/pull/11960#issuecomment-496066069)). This pull request removes the premade manpage. And it adds the manpage of `grml-zsh-config`, which depends on `txt2tags`, into the package. It also adds the `etc/zsh/keephack` file to `grml-zsh-config`.

A patch file from https://github.com/void-linux/void-packages/pull/31786.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-txt2tags-31786.patch --]
[-- Type: text/x-diff, Size: 19217 bytes --]

From 4ef5860a41acf6c95c2a74b391d55f646fc364ee Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 15:54:21 +0200
Subject: [PATCH 1/3] New package: txt2tags-3.7

This commit adds the python3 version of txt2tags.
---
 srcpkgs/txt2tags/template | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 srcpkgs/txt2tags/template

diff --git a/srcpkgs/txt2tags/template b/srcpkgs/txt2tags/template
new file mode 100644
index 000000000000..c62f1ec064d3
--- /dev/null
+++ b/srcpkgs/txt2tags/template
@@ -0,0 +1,23 @@
+# Template file for 'txt2tags'
+pkgname=txt2tags
+version=3.7
+revision=1
+build_style=python3-module
+hostmakedepends="python3 python3-setuptools"
+depends="python3"
+checkdepends="tox"
+
+if [ $XBPS_LIBC = "musl" ]; then
+	checkdepends+=" python3-devel"
+fi
+
+short_desc="Tool for converting plain text into many markup languages"
+maintainer="meator <coder64@protonmail.com>"
+license="GPL-2.0-or-later"
+homepage="https://txt2tags.org/"
+distfiles="https://github.com/txt2tags/txt2tags/archive/refs/tags/${version}.tar.gz"
+checksum=ba745fc1aa98996578afadeb325173f7032a40f161dc4f6f7a7aa08848d11d03
+
+do_check() {
+	tox
+}

From 4a3d3d1276d7f041c6d22dea34217fb177252efd Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:06:56 +0200
Subject: [PATCH 2/3] xdgmenumaker: remove pre-generated man page

The pre-generated man page is not needed anymore, because txt2tags is in the
repo. More info at https://github.com/void-linux/void-packages/pull/14645.
---
 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 | 463 ------------------
 srcpkgs/xdgmenumaker/template                 |  11 +-
 2 files changed, 8 insertions(+), 466 deletions(-)
 delete mode 100644 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1

diff --git a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 b/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
deleted file mode 100644
index 2dd5519afeac..000000000000
--- a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
+++ /dev/null
@@ -1,463 +0,0 @@
-.TH "xdgmenumaker" 1 "09/16/2018" "George Vlahavas"
-
-.SH NAME
-.P
-xdgmenumaker \- generate XDG menus
-.SH SYNOPSIS
-.P
-\fBxdgmenumaker\fR [\fIOPTIONS\fR]
-.SH DESCRIPTION
-.P
-\fBxdgmenumaker\fR is a command line tool, written in python, that
-generates application menus using XDG information, by scanning
-*.desktop files in all \fI$XDG_DATA_DIRS/applications\fR directories. All
-applications are sorted according to the main categories as specified
-by
-freedesktop.org (http://standards.freedesktop.org/menu\-spec/latest/apa.html)
-.P
-The menu entries that are generated by \fBxdgmenumaker\fR are localised
-according to the running user locale settings.
-.P
-\fBxdgmenumaker\fR currently supports generating menus for:
-
-.RS
-.IP \(bu 3
-amiwm
-.IP \(bu 3
-blackbox
-.IP \(bu 3
-compizboxmenu
-.IP \(bu 3
-fluxbox
-.IP \(bu 3
-fvwm
-.IP \(bu 3
-icewm
-.IP \(bu 3
-jwm
-.IP \(bu 3
-pekwm
-.IP \(bu 3
-twm and compatible derivatives such as ctwm and vtwm
-.IP \(bu 3
-windowmaker
-.RE
-.IP
-
-.P
-\fBxdgmenumaker\fR requires \fIPython 2.7\fR or \fI3.x\fR, \fIpygtk\fR
-(for Python 2.7) or \fIpygobject\fR and \fIgobject\-instrospection\fR
-(for Python 3.x), as well as \fIpyxdg\fR. \fIPillow\fR is an optional
-dependency (used by the \fB\-\-max\-icon\-size\fR option).
-.SH OPTIONS
-
-.TP
-\fB\-f, \-\-format\fR
-specify the output format to use. Valid options are \fIamiwm\fR, \fIblackbox\fR,
-\fIcompizboxmenu\fR, \fIfluxbox\fR, \fIfvwm\fR, \fIicewm\fR, \fIjwm\fR, \fIpekwm\fR,
-\fItwm\fR and \fIwindowmaker\fR.
-Specifying the output format is mandatory.
-
-.TP
-\fB\-i, \-\-icons\fR
-enable support for icons in the menus. This option does not have any
-effect for \fIamiwm\fR, \fIblackbox\fR or \fIwindowmaker\fR menus.
-
-.TP
-\fB\-s, \-\-size\fR
-set the preferred icon size in pixels. The default size is 16. You can
-set this to any number, but it generally makes sense to use standard
-icons sizes, like 16, 22, 24, 32 etc. Obviously this has an effect only
-if the \fI\-\-icons\fR option is used. You have to be careful with the sizes
-you use; some window managers don't support large icons in the menu.
-
-.TP
-\fB\-n, \-\-no\-submenu\fR
-do not create a submenu. Instead, place the application categories menus
-in the window manager's main menu. This option does not have any effect
-for \fIwindowmaker\fR menus.
-
-.TP
-\fB\-\-max\-icon\-size\fR
-restrict the maximum size for icons to the one specified with the
-\fI\-\-size\fR option. Any icons that are larger than the specified size
-will get discarded and will not be used.
-
-.TP
-\fB\-\-no\-svg\fR
-do not use SVG icons even for the WMs that support it. Right now that
-is only JWM.
-
-.TP
-\fB\-\-pekwm\-dynamic\fR
-create dynamic menus for pekwm. If you want to have dynamically
-generated menus for pekwm you have to use this option. Do not use it if
-you want to generate static menus for pekwm. Only works with \fIpekwm\fR
-of course.
-
-.TP
-\fB\-\-twm\-titles\fR
-display menu titles in TWM menus. Naturally, only has an effect when
-used with \fItwm\fR.
-
-.SH GENERAL OPTIONS
-
-.TP
-\fB\-h\fR
-Prints a usage message briefly summarizing all command\-line options
-and exits.
-
-.SH CONFIGURATION
-.P
-The terminal emulator to be used for menu entries that state that an
-application must be launched inside a terminal, can be specified in a
-\fI~/.config/xdgmenumaker.cfg\fR configuration file. Here's an example
-specifying \fBrxvt\fR as the default terminal emulator:
-
-.nf
-[Terminal]
-terminal = rxvt
-.fi
-
-
-.P
-If no such file is present, or if no terminal is set within the file,
-xdgmenumaker will default to the one specified in the debian
-alternatives system on debian and debian\-like systems and to xterm in
-any other case.
-.P
-Setting the path to a terminal emulator in an \fIXDGMENUMAKERTERM\fR
-environment variable will override any other setting.
-.SH USAGE
-
-.TP
-\fBAmiWM\fR
-
-You can generate a menu for AmiWM, running xdgmenumaker like this:
-
-$ xdgmenumaker \-f amiwm > ~/.amiwm\-xdgmenu
-
-As AmiWM does not support including other files in its settings file,
-you'll have to copy the contents of the created file in your
-\fI~/.amiwmrc\fR. It should be possible to create a script that would
-generate the main \fI~/.amiwmrc\fR file from different "source" files, but
-I'll leave that as an exercise to the user.
-
-.TP
-\fBBlackbox\fR
-
-To generate an application menu for Blackbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu
-
-and then change your main Blackbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.blackbox/menu\fR file:
-
-[include] (~/.blackbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Blackbox Menu) {xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu}
-
-.TP
-\fBCompiz Boxmenu\fR
-
-There are two ways to have an xdg menu in compiz\-boxmenu. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and add a block of code like this inside the root \fI<menu>\fR element:
-
-.nf
-<item type="launcher">
-  <command mode2="pipe">xdgmenumaker -nif compizboxmenu</command>
-  <icon>applications-other</icon>
-  <name>Applications</name>
-</item>
-.fi
-
-
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-dropdown for new menu files or menu items. Select launcher to create a
-new launcher. Set the name of the launcher to whatever you want. This will
-be the display name for the pipe menu. Then enter in:
-
-xdgmenumaker \-nif compizboxmenu
-
-for the command entry. Click the combobox
-next to the command text box and switch that to "Pipe".
-
-\fBStatic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and paste the output of:
-
-$ xdgmenumaker \-if compizboxmenu
-
-into \fI~/.config/compiz/boxmenu/menu.xml\fR.
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-button that says \fIGenerate menu entries from a pipemenu script\fR. In the dialog
-box that pops up, type in:
-
-xdgmenumaker \-if compizboxmenu
-
-to append the statically generated menu to any menu file you want.
-
-.TP
-\fBFluxbox\fR
-
-To generate an application menu for Fluxbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu
-
-and then change your main Fluxbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.fluxbox/menu\fR file:
-
-[include] (~/.fluxbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Fluxbox Menu) {xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu}
-
-.TP
-\fBFvwm\fR
-
-To generate an application menu for Fvwm, you can run \fBxdgmenumaker\fR
-like this:
-
-$ xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and then edit your main Fvwm configuration file and add a line to read
-that file:
-
-read xdgmenu
-
-and also include it somewhere in your main menu, for example:
-
-.nf
-AddToMenu MenuFvwmRoot  "Root Menu"             Title
-+                       "Applications"          Popup xdgmenu
-.fi
-
-
-You could also put the menus for individual categories in your main menu
-if you want. Just look in the ~/.fvwm/xdgmenu file for the category
-names.
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it:
-
-+ "Update Fvwm Menu" Exec xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and restart Fvwm to apply the changes.
-
-\fINOTE:\fR If you're going to use the \fI\-\-icons\fR option to include icons
-in your menus, you might consider using the \fI\-\-max\-icon\-size\fR
-option too. Fvwm does not resize icons in its menu and having entries
-with icons that are too big makes for funny looking menus.
-
-.TP
-\fBIceWM\fR
-
-To generate an application menu for IceWM, run \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f icewm > ~/.icewm/appmenu
-
-or if you want icons in your menu:
-
-$ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-and you can then edit your \fI~/.icewm/menu\fR file and add this line
-somewhere:
-
-include appmenu
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu, if
-you want to update it, without having to run the command manually again:
-
-prog "Update Menu" _none_ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-\fINOTE:\fR If you don't request icons in the menu, or if an icon is not found
-for a certain app, the icon name in the menu for that app is set to
-"_none_". This doesn't actually set the icon for that app to none.
-IceWM menu entries should always include an icon . So, by pointing it
-to a non existing icon, you essentially set it to use no icon. If you
-actually have an icewm icon named "_none_", that one will be used instead.
-
-.TP
-\fBJWM\fR
-
-You can edit your \fI~/.jwmrc\fR file and add a line that generates the
-applications menu, like this:
-
-<Include>exec: xdgmenumaker \-n \-i \-f jwm</Include>
-
-You need to put that line somewhere in the \fIRootMenu\fR section of the
-\fI~/.jwmrc\fR file.
-
-You can update the menu with:
-
-$ jwm \-reload
-
-Or you can restart JWM and the updated menu should appear. The menu will be
-recreated every time JWM is started, restarted, or when the menu is
-reloaded with the above command. You can even add a menu item that will
-refresh the menu, like this:
-
-<Program label="Refresh Menu">jwm \-reload</Program>
-
-.TP
-\fBpekwm\fR
-
-There are two ways to have an XDG menu in pekwm. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.pekwm/menu\fR file with your favourite text editor and add
-a line like the following one in the location that you want the
-dynamically generated menu to appear:
-
-.nf
-Entry = "" { Actions = "Dynamic /usr/bin/xdgmenumaker -n -i -f pekwm --pekwm-dynamic" }
-.fi
-
-
-
-Restart pekwm and the generated menu should appear. The menu will be
-automatically generated every time you access it, so it will always be
-up to date. But since xdgmenumaker will run every time you access the
-menu, the menu might not appear instantly, especially if you are using
-an older PC.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-n \-i \-f pekwm > ~/.pekwm/appsmenu
-
-to create a file with the menu contents. Then edit your
-\fI~/.pekwm/menu\fR file to include that menu, by adding a line like the
-following, in the location that you want the menu to appear:
-
-INCLUDE = "/home/your_user_name/.pekwm/appsmenu"
-
-Restart pekwm and the generated menu should appear. The menu is static
-and if you add/remove any applications, you will have to run the
-xdgmenumaker command and restart pekwm all over again to update it. The
-advantage is that there will be no delay in displaying the menu.
-
-.TP
-\fBTWM and Derivatives\fR
-
-You can create a menu for TWM running \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f twm > ~/.twm\-xdgmenu
-
-If you're using the standard TWM, then unfortunately you'll have to
-manually copy/paste the contents of the generated \fI~/.twm\-xdgmenu\fR file
-into your \fI~/.twmrc\fR manually. You could then add something like this
-to your main menu definition:
-
-.nf
-"Applications" f.menu "xdgmenu"
-.fi
-
-
-
-It could be possible to create a script that updates the menus inside
-the main \fI~/.twmrc\fR settings file, but I'll leave that as an exercise
-for the user.
-
-If you're using CTWM or VTWM, instead of manually copy/pasting the menu
-contents into your settings file, you could just add an include line
-like this:
-
-.nf
-sinclude(`/home/george/.twm-xdgmenu')
-.fi
-
-
-
-\fINote:\fR In order for this to work with VTWM, \fBvtwm\fR has to be called
-with the \fI\-m\fR switch.
-
-.TP
-\fBWindowMaker\fR
-
-There are two ways to have an XDG menu in WindowMaker. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBxdgmenumaker\fR uses utf8 encoding and localised strings by default
-and has been tested only with wmaker\-crm>=0.95.1. No idea if utf8 works
-properly with older WindowMaker versions.
-
-\fBDynamic Menus\fR
-
-Open the WindowMaker preferences tool. In the \fIApplication Menu Definition\fR
-section, add a \fIGenerated Submenu\fR in your menu, by dragging it
-in. Click on the menu item you just dragged in and in the preferences
-window, in \fICommand\fR, add:
-
-xdgmenumaker \-f windowmaker
-
-Save and close the preferences window.
-
-That command will be run every time you access that submenu, so the
-application list in there will be always up to date. The downside is
-that with running this command every time, especially if
-you are on a very old PC, it might slow things down a bit. Even then it
-is probably not anything considerable.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-f windowmaker > ~/GNUstep/Defaults/xdg_menu
-
-Then open the WindowMaker preferences tool and in the
-\fIApplication Menu Definition\fR section, add an
-\fIExternal Submenu\fR by dragging it in your menu.
-Click on the menu item you just dragged in and in the preferences
-window, in \fIPath for Menu\fR, add the location of the menu file you just
-created:
-
-~/GNUstep/Defaults/xdg_menu
-
-You can add the above mentioned \fBxdgmenumaker\fR command as another
-item in your menu, if you want to update it, without having to run the
-command manually again.
-In the \fIApplication Menu Definition\fR section in the WindowMaker
-preferences window, add a \fIRun Program\fR item in your menu by dragging it
-your menu. Click on the menu item you just dragged in and in the
-preferences window, in \fIProgram to Run\fR, add the \fBxdgmenumaker\fR command as
-mentioned above.
-
-The downside of this method, is that the menu contents will not be
-updated when you install a new application or remove one. You will need
-to run the xdgmenumaker command every time you want the menu to be
-updated. The upside is that the menu will not be generated every time
-you access the menu. This might be a better choice for (really) older
-hardware.
-
-.SH WEBSITE
-.P
-https://github.com/gapan/xdgmenumaker
-.SH AUTHORS
-.P
-\fBxdgmenumaker\fR was written by George Vlahavas <vlahavas~at~gmail~dot~com>
-
-.\" man code generated by txt2tags 2.6. (http://txt2tags.org)
diff --git a/srcpkgs/xdgmenumaker/template b/srcpkgs/xdgmenumaker/template
index a71ccd9b3759..7dd2087bf7df 100644
--- a/srcpkgs/xdgmenumaker/template
+++ b/srcpkgs/xdgmenumaker/template
@@ -1,8 +1,9 @@
 # Template file for 'xdgmenumaker'
 pkgname=xdgmenumaker
 version=1.6
-revision=1
+revision=2
 build_style=gnu-makefile
+hostmakedepends="txt2tags"
 depends="python3-xdg python3-gobject gobject-introspection python3-Pillow"
 short_desc="Automatic menu generator for WMs, such as, fluxbox, icewm, jwm, pekwm"
 maintainer="reback00 <reback00@protonmail.com>"
@@ -12,9 +13,13 @@ distfiles="https://github.com/gapan/${pkgname}/archive/${version}.tar.gz"
 checksum=46192e7e4e25b024c0516d83e8fc2c503dd1ac8e5f8c1998d3e9e4b3cbf8919b
 python_version=3
 
+pre_build() {
+	txt2tags --target man man/xdgmenumaker.t2t
+}
+
 pre_install() {
-	# Install pre-generated man page
-	vman ${FILESDIR}/${version}/xdgmenumaker.1
+	# Install generated man page
+	vman man/xdgmenumaker.1
 	# Install README.md as documentation
 	vdoc README.md
 }

From 79e336201eb5f66f7680059dab035632a59dc3a9 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:14:32 +0200
Subject: [PATCH 3/3] grml-zsh-config: add manpage and a missing file

This commit generates the grmlzshrc(5) man page via txt2tags and adds
it to the package and adds the etc/zsh/keephack file  into the
package.
---
 srcpkgs/grml-zsh-config/template | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/srcpkgs/grml-zsh-config/template b/srcpkgs/grml-zsh-config/template
index 50efbb7d5abb..8e0199b292c6 100644
--- a/srcpkgs/grml-zsh-config/template
+++ b/srcpkgs/grml-zsh-config/template
@@ -1,8 +1,9 @@
 # Template file for 'grml-zsh-config'
 pkgname=grml-zsh-config
 version=0.18.0
-revision=1
+revision=2
 wrksrc="grml-etc-core-${version}"
+hostmakedepends="make txt2tags"
 short_desc="Grml's zsh setup"
 maintainer="Christian Poulwey <christian.poulwey@t-online.de>"
 license="GPL-2.0-only"
@@ -10,7 +11,13 @@ homepage="https://grml.org/zsh/"
 distfiles="https://deb.grml.org/pool/main/g/grml-etc-core/grml-etc-core_${version}.tar.gz"
 checksum=81bce54ac1cde04d426182b72ffa9077b26f80bcceca4cb9580de4e031a5088f
 
+pre_build() {
+	make -C doc/ grmlzshrc.5
+}
+
 do_install() {
 	vinstall etc/skel/.zshrc 0644 etc/skel
 	vinstall etc/zsh/zshrc 0644 etc/zsh
+	vinstall etc/zsh/keephack 0644 etc/zsh
+	vman doc/grmlzshrc.5
 }

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (2 preceding siblings ...)
  2021-07-03 17:30 ` [PR PATCH] [Updated] " meator
@ 2021-07-03 17:45 ` meator
  2021-07-03 17:55 ` [PR REVIEW] " Chocimier
                   ` (6 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-03 17:45 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 168 bytes --]

New comment by meator on void-packages repository

https://github.com/void-linux/void-packages/pull/31786#issuecomment-873443845

Comment:
I fixed it. Thanks @paper42!

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PR REVIEW] Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (3 preceding siblings ...)
  2021-07-03 17:45 ` Add txt2tags " meator
@ 2021-07-03 17:55 ` Chocimier
  2021-07-03 18:21 ` meator
                   ` (5 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Chocimier @ 2021-07-03 17:55 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 452 bytes --]

New review comment by Chocimier on void-packages repository

https://github.com/void-linux/void-packages/pull/31786#discussion_r663391665

Comment:
Looks line useful tests are skipped that way, and only useless are run. Please rather do following, without any checkkdepends:

    do_check() {
    	vsed -i test/lib.py -e 's:TXT2TAGS = ".*:TXT2TAGS = "build/lib/txt2tags.py":'
    	chmod u+x build/lib/txt2tags.py
    	python3 test/run.py
    }


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PR REVIEW] Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (4 preceding siblings ...)
  2021-07-03 17:55 ` [PR REVIEW] " Chocimier
@ 2021-07-03 18:21 ` meator
  2021-07-03 18:22 ` [PR PATCH] [Updated] " meator
                   ` (4 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-03 18:21 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 157 bytes --]

New review comment by meator on void-packages repository

https://github.com/void-linux/void-packages/pull/31786#discussion_r663394085

Comment:
Ok, thanks!

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PR PATCH] [Updated] Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (5 preceding siblings ...)
  2021-07-03 18:21 ` meator
@ 2021-07-03 18:22 ` meator
  2021-07-04 13:48 ` meator
                   ` (3 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-03 18:22 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 2469 bytes --]

There is an updated pull request by meator against master on the void-packages repository

https://github.com/meator/void-packages txt2tags
https://github.com/void-linux/void-packages/pull/31786

Add txt2tags and change manpages of some programs
<!-- Mark items with [x] where applicable -->

#### General
- [x] This is a new package and it conforms to the [quality requirements](https://github.com/void-linux/void-packages/blob/master/Manual.md#quality-requirements)

#### Have the results of the proposed changes been tested?
- [x] I use the packages affected by the proposed changes on a regular basis and confirm this PR works for me
- [ ] I generally don't use the affected packages but briefly tested this PR

<!--
If GitHub CI cannot be used to validate the build result (for example, if the
build is likely to take several hours), make sure to
[skip CI](https://github.com/void-linux/void-packages/blob/master/CONTRIBUTING.md#continuous-integration).
When skipping CI, uncomment and fill out the following section.
Note: for builds that are likely to complete in less than 2 hours, it is not
acceptable to skip CI.
-->
#### Does it build and run successfully? 
(Please choose at least one native build and, if supported, at least one cross build. More are better.)
- [x] I built this PR locally for my native architecture, (x86_64-glibc)
- [x] I built this PR locally for these architectures (if supported. mark crossbuilds):
  - [ ] aarch64-musl
  - [x] armv7l
  - [ ] armv6l-musl
---
This pull request adds the `txt2tags` package, adds a manpage and a missing file to `grml-zsh-config` and removes the pre-generated manpage in `xdgmenumaker`.

The `txt2tag` package was supposed to be added, but [was rejected](https://github.com/void-linux/void-packages/pull/11960#discussion_r287600511) because it only had a python2 version at the time. There is a python3 version now, so I want to add it here. The `xdgmenumaker` package has to include a precompiled version of its manpage in `files/`, because the `txt2tags` package isn't in the repo (more info [here](https://github.com/void-linux/void-packages/pull/11960#issuecomment-496066069)). This pull request removes the premade manpage. And it adds the manpage of `grml-zsh-config`, which depends on `txt2tags`, into the package. It also adds the `etc/zsh/keephack` file to `grml-zsh-config`.

A patch file from https://github.com/void-linux/void-packages/pull/31786.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-txt2tags-31786.patch --]
[-- Type: text/x-diff, Size: 19248 bytes --]

From a5ea0e8bb782fb424bc42feb3025bc0be1a715bd Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 15:54:21 +0200
Subject: [PATCH 1/3] New package: txt2tags-3.7

This commit adds the python3 version of txt2tags.
---
 srcpkgs/txt2tags/template | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 srcpkgs/txt2tags/template

diff --git a/srcpkgs/txt2tags/template b/srcpkgs/txt2tags/template
new file mode 100644
index 000000000000..ac72e72deaec
--- /dev/null
+++ b/srcpkgs/txt2tags/template
@@ -0,0 +1,19 @@
+# Template file for 'txt2tags'
+pkgname=txt2tags
+version=3.7
+revision=1
+build_style=python3-module
+hostmakedepends="python3 python3-setuptools"
+depends="python3"
+short_desc="Tool for converting plain text into many markup languages"
+maintainer="meator <coder64@protonmail.com>"
+license="GPL-2.0-or-later"
+homepage="https://txt2tags.org/"
+distfiles="https://github.com/txt2tags/txt2tags/archive/refs/tags/${version}.tar.gz"
+checksum=ba745fc1aa98996578afadeb325173f7032a40f161dc4f6f7a7aa08848d11d03
+
+do_check() {
+	vsed -i test/lib.py -e 's:TXT2TAGS = ".*:TXT2TAGS = "build/lib/txt2tags.py":'
+	chmod u+x build/lib/txt2tags.py
+	python3 test/run.py
+}

From 0922f37b4215429c750fd4a4bcfa0b04b91cafba Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:06:56 +0200
Subject: [PATCH 2/3] xdgmenumaker: remove pre-generated man page

The pre-generated man page is not needed anymore, because txt2tags is in the
repo. More info at https://github.com/void-linux/void-packages/pull/14645.
---
 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 | 463 ------------------
 srcpkgs/xdgmenumaker/template                 |  11 +-
 2 files changed, 8 insertions(+), 466 deletions(-)
 delete mode 100644 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1

diff --git a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 b/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
deleted file mode 100644
index 2dd5519afeac..000000000000
--- a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
+++ /dev/null
@@ -1,463 +0,0 @@
-.TH "xdgmenumaker" 1 "09/16/2018" "George Vlahavas"
-
-.SH NAME
-.P
-xdgmenumaker \- generate XDG menus
-.SH SYNOPSIS
-.P
-\fBxdgmenumaker\fR [\fIOPTIONS\fR]
-.SH DESCRIPTION
-.P
-\fBxdgmenumaker\fR is a command line tool, written in python, that
-generates application menus using XDG information, by scanning
-*.desktop files in all \fI$XDG_DATA_DIRS/applications\fR directories. All
-applications are sorted according to the main categories as specified
-by
-freedesktop.org (http://standards.freedesktop.org/menu\-spec/latest/apa.html)
-.P
-The menu entries that are generated by \fBxdgmenumaker\fR are localised
-according to the running user locale settings.
-.P
-\fBxdgmenumaker\fR currently supports generating menus for:
-
-.RS
-.IP \(bu 3
-amiwm
-.IP \(bu 3
-blackbox
-.IP \(bu 3
-compizboxmenu
-.IP \(bu 3
-fluxbox
-.IP \(bu 3
-fvwm
-.IP \(bu 3
-icewm
-.IP \(bu 3
-jwm
-.IP \(bu 3
-pekwm
-.IP \(bu 3
-twm and compatible derivatives such as ctwm and vtwm
-.IP \(bu 3
-windowmaker
-.RE
-.IP
-
-.P
-\fBxdgmenumaker\fR requires \fIPython 2.7\fR or \fI3.x\fR, \fIpygtk\fR
-(for Python 2.7) or \fIpygobject\fR and \fIgobject\-instrospection\fR
-(for Python 3.x), as well as \fIpyxdg\fR. \fIPillow\fR is an optional
-dependency (used by the \fB\-\-max\-icon\-size\fR option).
-.SH OPTIONS
-
-.TP
-\fB\-f, \-\-format\fR
-specify the output format to use. Valid options are \fIamiwm\fR, \fIblackbox\fR,
-\fIcompizboxmenu\fR, \fIfluxbox\fR, \fIfvwm\fR, \fIicewm\fR, \fIjwm\fR, \fIpekwm\fR,
-\fItwm\fR and \fIwindowmaker\fR.
-Specifying the output format is mandatory.
-
-.TP
-\fB\-i, \-\-icons\fR
-enable support for icons in the menus. This option does not have any
-effect for \fIamiwm\fR, \fIblackbox\fR or \fIwindowmaker\fR menus.
-
-.TP
-\fB\-s, \-\-size\fR
-set the preferred icon size in pixels. The default size is 16. You can
-set this to any number, but it generally makes sense to use standard
-icons sizes, like 16, 22, 24, 32 etc. Obviously this has an effect only
-if the \fI\-\-icons\fR option is used. You have to be careful with the sizes
-you use; some window managers don't support large icons in the menu.
-
-.TP
-\fB\-n, \-\-no\-submenu\fR
-do not create a submenu. Instead, place the application categories menus
-in the window manager's main menu. This option does not have any effect
-for \fIwindowmaker\fR menus.
-
-.TP
-\fB\-\-max\-icon\-size\fR
-restrict the maximum size for icons to the one specified with the
-\fI\-\-size\fR option. Any icons that are larger than the specified size
-will get discarded and will not be used.
-
-.TP
-\fB\-\-no\-svg\fR
-do not use SVG icons even for the WMs that support it. Right now that
-is only JWM.
-
-.TP
-\fB\-\-pekwm\-dynamic\fR
-create dynamic menus for pekwm. If you want to have dynamically
-generated menus for pekwm you have to use this option. Do not use it if
-you want to generate static menus for pekwm. Only works with \fIpekwm\fR
-of course.
-
-.TP
-\fB\-\-twm\-titles\fR
-display menu titles in TWM menus. Naturally, only has an effect when
-used with \fItwm\fR.
-
-.SH GENERAL OPTIONS
-
-.TP
-\fB\-h\fR
-Prints a usage message briefly summarizing all command\-line options
-and exits.
-
-.SH CONFIGURATION
-.P
-The terminal emulator to be used for menu entries that state that an
-application must be launched inside a terminal, can be specified in a
-\fI~/.config/xdgmenumaker.cfg\fR configuration file. Here's an example
-specifying \fBrxvt\fR as the default terminal emulator:
-
-.nf
-[Terminal]
-terminal = rxvt
-.fi
-
-
-.P
-If no such file is present, or if no terminal is set within the file,
-xdgmenumaker will default to the one specified in the debian
-alternatives system on debian and debian\-like systems and to xterm in
-any other case.
-.P
-Setting the path to a terminal emulator in an \fIXDGMENUMAKERTERM\fR
-environment variable will override any other setting.
-.SH USAGE
-
-.TP
-\fBAmiWM\fR
-
-You can generate a menu for AmiWM, running xdgmenumaker like this:
-
-$ xdgmenumaker \-f amiwm > ~/.amiwm\-xdgmenu
-
-As AmiWM does not support including other files in its settings file,
-you'll have to copy the contents of the created file in your
-\fI~/.amiwmrc\fR. It should be possible to create a script that would
-generate the main \fI~/.amiwmrc\fR file from different "source" files, but
-I'll leave that as an exercise to the user.
-
-.TP
-\fBBlackbox\fR
-
-To generate an application menu for Blackbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu
-
-and then change your main Blackbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.blackbox/menu\fR file:
-
-[include] (~/.blackbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Blackbox Menu) {xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu}
-
-.TP
-\fBCompiz Boxmenu\fR
-
-There are two ways to have an xdg menu in compiz\-boxmenu. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and add a block of code like this inside the root \fI<menu>\fR element:
-
-.nf
-<item type="launcher">
-  <command mode2="pipe">xdgmenumaker -nif compizboxmenu</command>
-  <icon>applications-other</icon>
-  <name>Applications</name>
-</item>
-.fi
-
-
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-dropdown for new menu files or menu items. Select launcher to create a
-new launcher. Set the name of the launcher to whatever you want. This will
-be the display name for the pipe menu. Then enter in:
-
-xdgmenumaker \-nif compizboxmenu
-
-for the command entry. Click the combobox
-next to the command text box and switch that to "Pipe".
-
-\fBStatic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and paste the output of:
-
-$ xdgmenumaker \-if compizboxmenu
-
-into \fI~/.config/compiz/boxmenu/menu.xml\fR.
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-button that says \fIGenerate menu entries from a pipemenu script\fR. In the dialog
-box that pops up, type in:
-
-xdgmenumaker \-if compizboxmenu
-
-to append the statically generated menu to any menu file you want.
-
-.TP
-\fBFluxbox\fR
-
-To generate an application menu for Fluxbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu
-
-and then change your main Fluxbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.fluxbox/menu\fR file:
-
-[include] (~/.fluxbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Fluxbox Menu) {xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu}
-
-.TP
-\fBFvwm\fR
-
-To generate an application menu for Fvwm, you can run \fBxdgmenumaker\fR
-like this:
-
-$ xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and then edit your main Fvwm configuration file and add a line to read
-that file:
-
-read xdgmenu
-
-and also include it somewhere in your main menu, for example:
-
-.nf
-AddToMenu MenuFvwmRoot  "Root Menu"             Title
-+                       "Applications"          Popup xdgmenu
-.fi
-
-
-You could also put the menus for individual categories in your main menu
-if you want. Just look in the ~/.fvwm/xdgmenu file for the category
-names.
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it:
-
-+ "Update Fvwm Menu" Exec xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and restart Fvwm to apply the changes.
-
-\fINOTE:\fR If you're going to use the \fI\-\-icons\fR option to include icons
-in your menus, you might consider using the \fI\-\-max\-icon\-size\fR
-option too. Fvwm does not resize icons in its menu and having entries
-with icons that are too big makes for funny looking menus.
-
-.TP
-\fBIceWM\fR
-
-To generate an application menu for IceWM, run \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f icewm > ~/.icewm/appmenu
-
-or if you want icons in your menu:
-
-$ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-and you can then edit your \fI~/.icewm/menu\fR file and add this line
-somewhere:
-
-include appmenu
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu, if
-you want to update it, without having to run the command manually again:
-
-prog "Update Menu" _none_ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-\fINOTE:\fR If you don't request icons in the menu, or if an icon is not found
-for a certain app, the icon name in the menu for that app is set to
-"_none_". This doesn't actually set the icon for that app to none.
-IceWM menu entries should always include an icon . So, by pointing it
-to a non existing icon, you essentially set it to use no icon. If you
-actually have an icewm icon named "_none_", that one will be used instead.
-
-.TP
-\fBJWM\fR
-
-You can edit your \fI~/.jwmrc\fR file and add a line that generates the
-applications menu, like this:
-
-<Include>exec: xdgmenumaker \-n \-i \-f jwm</Include>
-
-You need to put that line somewhere in the \fIRootMenu\fR section of the
-\fI~/.jwmrc\fR file.
-
-You can update the menu with:
-
-$ jwm \-reload
-
-Or you can restart JWM and the updated menu should appear. The menu will be
-recreated every time JWM is started, restarted, or when the menu is
-reloaded with the above command. You can even add a menu item that will
-refresh the menu, like this:
-
-<Program label="Refresh Menu">jwm \-reload</Program>
-
-.TP
-\fBpekwm\fR
-
-There are two ways to have an XDG menu in pekwm. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.pekwm/menu\fR file with your favourite text editor and add
-a line like the following one in the location that you want the
-dynamically generated menu to appear:
-
-.nf
-Entry = "" { Actions = "Dynamic /usr/bin/xdgmenumaker -n -i -f pekwm --pekwm-dynamic" }
-.fi
-
-
-
-Restart pekwm and the generated menu should appear. The menu will be
-automatically generated every time you access it, so it will always be
-up to date. But since xdgmenumaker will run every time you access the
-menu, the menu might not appear instantly, especially if you are using
-an older PC.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-n \-i \-f pekwm > ~/.pekwm/appsmenu
-
-to create a file with the menu contents. Then edit your
-\fI~/.pekwm/menu\fR file to include that menu, by adding a line like the
-following, in the location that you want the menu to appear:
-
-INCLUDE = "/home/your_user_name/.pekwm/appsmenu"
-
-Restart pekwm and the generated menu should appear. The menu is static
-and if you add/remove any applications, you will have to run the
-xdgmenumaker command and restart pekwm all over again to update it. The
-advantage is that there will be no delay in displaying the menu.
-
-.TP
-\fBTWM and Derivatives\fR
-
-You can create a menu for TWM running \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f twm > ~/.twm\-xdgmenu
-
-If you're using the standard TWM, then unfortunately you'll have to
-manually copy/paste the contents of the generated \fI~/.twm\-xdgmenu\fR file
-into your \fI~/.twmrc\fR manually. You could then add something like this
-to your main menu definition:
-
-.nf
-"Applications" f.menu "xdgmenu"
-.fi
-
-
-
-It could be possible to create a script that updates the menus inside
-the main \fI~/.twmrc\fR settings file, but I'll leave that as an exercise
-for the user.
-
-If you're using CTWM or VTWM, instead of manually copy/pasting the menu
-contents into your settings file, you could just add an include line
-like this:
-
-.nf
-sinclude(`/home/george/.twm-xdgmenu')
-.fi
-
-
-
-\fINote:\fR In order for this to work with VTWM, \fBvtwm\fR has to be called
-with the \fI\-m\fR switch.
-
-.TP
-\fBWindowMaker\fR
-
-There are two ways to have an XDG menu in WindowMaker. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBxdgmenumaker\fR uses utf8 encoding and localised strings by default
-and has been tested only with wmaker\-crm>=0.95.1. No idea if utf8 works
-properly with older WindowMaker versions.
-
-\fBDynamic Menus\fR
-
-Open the WindowMaker preferences tool. In the \fIApplication Menu Definition\fR
-section, add a \fIGenerated Submenu\fR in your menu, by dragging it
-in. Click on the menu item you just dragged in and in the preferences
-window, in \fICommand\fR, add:
-
-xdgmenumaker \-f windowmaker
-
-Save and close the preferences window.
-
-That command will be run every time you access that submenu, so the
-application list in there will be always up to date. The downside is
-that with running this command every time, especially if
-you are on a very old PC, it might slow things down a bit. Even then it
-is probably not anything considerable.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-f windowmaker > ~/GNUstep/Defaults/xdg_menu
-
-Then open the WindowMaker preferences tool and in the
-\fIApplication Menu Definition\fR section, add an
-\fIExternal Submenu\fR by dragging it in your menu.
-Click on the menu item you just dragged in and in the preferences
-window, in \fIPath for Menu\fR, add the location of the menu file you just
-created:
-
-~/GNUstep/Defaults/xdg_menu
-
-You can add the above mentioned \fBxdgmenumaker\fR command as another
-item in your menu, if you want to update it, without having to run the
-command manually again.
-In the \fIApplication Menu Definition\fR section in the WindowMaker
-preferences window, add a \fIRun Program\fR item in your menu by dragging it
-your menu. Click on the menu item you just dragged in and in the
-preferences window, in \fIProgram to Run\fR, add the \fBxdgmenumaker\fR command as
-mentioned above.
-
-The downside of this method, is that the menu contents will not be
-updated when you install a new application or remove one. You will need
-to run the xdgmenumaker command every time you want the menu to be
-updated. The upside is that the menu will not be generated every time
-you access the menu. This might be a better choice for (really) older
-hardware.
-
-.SH WEBSITE
-.P
-https://github.com/gapan/xdgmenumaker
-.SH AUTHORS
-.P
-\fBxdgmenumaker\fR was written by George Vlahavas <vlahavas~at~gmail~dot~com>
-
-.\" man code generated by txt2tags 2.6. (http://txt2tags.org)
diff --git a/srcpkgs/xdgmenumaker/template b/srcpkgs/xdgmenumaker/template
index a71ccd9b3759..7dd2087bf7df 100644
--- a/srcpkgs/xdgmenumaker/template
+++ b/srcpkgs/xdgmenumaker/template
@@ -1,8 +1,9 @@
 # Template file for 'xdgmenumaker'
 pkgname=xdgmenumaker
 version=1.6
-revision=1
+revision=2
 build_style=gnu-makefile
+hostmakedepends="txt2tags"
 depends="python3-xdg python3-gobject gobject-introspection python3-Pillow"
 short_desc="Automatic menu generator for WMs, such as, fluxbox, icewm, jwm, pekwm"
 maintainer="reback00 <reback00@protonmail.com>"
@@ -12,9 +13,13 @@ distfiles="https://github.com/gapan/${pkgname}/archive/${version}.tar.gz"
 checksum=46192e7e4e25b024c0516d83e8fc2c503dd1ac8e5f8c1998d3e9e4b3cbf8919b
 python_version=3
 
+pre_build() {
+	txt2tags --target man man/xdgmenumaker.t2t
+}
+
 pre_install() {
-	# Install pre-generated man page
-	vman ${FILESDIR}/${version}/xdgmenumaker.1
+	# Install generated man page
+	vman man/xdgmenumaker.1
 	# Install README.md as documentation
 	vdoc README.md
 }

From ded193da680c6fd4c228fa299205b308261c01d2 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:14:32 +0200
Subject: [PATCH 3/3] grml-zsh-config: add manpage and a missing file

This commit generates the grmlzshrc(5) man page via txt2tags and adds
it to the package and adds the etc/zsh/keephack file  into the
package.
---
 srcpkgs/grml-zsh-config/template | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/srcpkgs/grml-zsh-config/template b/srcpkgs/grml-zsh-config/template
index 50efbb7d5abb..8e0199b292c6 100644
--- a/srcpkgs/grml-zsh-config/template
+++ b/srcpkgs/grml-zsh-config/template
@@ -1,8 +1,9 @@
 # Template file for 'grml-zsh-config'
 pkgname=grml-zsh-config
 version=0.18.0
-revision=1
+revision=2
 wrksrc="grml-etc-core-${version}"
+hostmakedepends="make txt2tags"
 short_desc="Grml's zsh setup"
 maintainer="Christian Poulwey <christian.poulwey@t-online.de>"
 license="GPL-2.0-only"
@@ -10,7 +11,13 @@ homepage="https://grml.org/zsh/"
 distfiles="https://deb.grml.org/pool/main/g/grml-etc-core/grml-etc-core_${version}.tar.gz"
 checksum=81bce54ac1cde04d426182b72ffa9077b26f80bcceca4cb9580de4e031a5088f
 
+pre_build() {
+	make -C doc/ grmlzshrc.5
+}
+
 do_install() {
 	vinstall etc/skel/.zshrc 0644 etc/skel
 	vinstall etc/zsh/zshrc 0644 etc/zsh
+	vinstall etc/zsh/keephack 0644 etc/zsh
+	vman doc/grmlzshrc.5
 }

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (6 preceding siblings ...)
  2021-07-03 18:22 ` [PR PATCH] [Updated] " meator
@ 2021-07-04 13:48 ` meator
  2021-07-09 19:23 ` [PR PATCH] [Updated] " meator
                   ` (2 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-04 13:48 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 192 bytes --]

New comment by meator on void-packages repository

https://github.com/void-linux/void-packages/pull/31786#issuecomment-873594664

Comment:
Should I leave the revision of `xdgmenumaker` as is?

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PR PATCH] [Updated] Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (7 preceding siblings ...)
  2021-07-04 13:48 ` meator
@ 2021-07-09 19:23 ` meator
  2021-07-10 19:00 ` Chocimier
  2021-07-10 19:00 ` [PR PATCH] [Merged]: " Chocimier
  10 siblings, 0 replies; 12+ messages in thread
From: meator @ 2021-07-09 19:23 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 2469 bytes --]

There is an updated pull request by meator against master on the void-packages repository

https://github.com/meator/void-packages txt2tags
https://github.com/void-linux/void-packages/pull/31786

Add txt2tags and change manpages of some programs
<!-- Mark items with [x] where applicable -->

#### General
- [x] This is a new package and it conforms to the [quality requirements](https://github.com/void-linux/void-packages/blob/master/Manual.md#quality-requirements)

#### Have the results of the proposed changes been tested?
- [x] I use the packages affected by the proposed changes on a regular basis and confirm this PR works for me
- [ ] I generally don't use the affected packages but briefly tested this PR

<!--
If GitHub CI cannot be used to validate the build result (for example, if the
build is likely to take several hours), make sure to
[skip CI](https://github.com/void-linux/void-packages/blob/master/CONTRIBUTING.md#continuous-integration).
When skipping CI, uncomment and fill out the following section.
Note: for builds that are likely to complete in less than 2 hours, it is not
acceptable to skip CI.
-->
#### Does it build and run successfully? 
(Please choose at least one native build and, if supported, at least one cross build. More are better.)
- [x] I built this PR locally for my native architecture, (x86_64-glibc)
- [x] I built this PR locally for these architectures (if supported. mark crossbuilds):
  - [ ] aarch64-musl
  - [x] armv7l
  - [ ] armv6l-musl
---
This pull request adds the `txt2tags` package, adds a manpage and a missing file to `grml-zsh-config` and removes the pre-generated manpage in `xdgmenumaker`.

The `txt2tag` package was supposed to be added, but [was rejected](https://github.com/void-linux/void-packages/pull/11960#discussion_r287600511) because it only had a python2 version at the time. There is a python3 version now, so I want to add it here. The `xdgmenumaker` package has to include a precompiled version of its manpage in `files/`, because the `txt2tags` package isn't in the repo (more info [here](https://github.com/void-linux/void-packages/pull/11960#issuecomment-496066069)). This pull request removes the premade manpage. And it adds the manpage of `grml-zsh-config`, which depends on `txt2tags`, into the package. It also adds the `etc/zsh/keephack` file to `grml-zsh-config`.

A patch file from https://github.com/void-linux/void-packages/pull/31786.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-txt2tags-31786.patch --]
[-- Type: text/x-diff, Size: 19244 bytes --]

From 6295d3d57370b48638de49dd7f7290a31dac0556 Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 15:54:21 +0200
Subject: [PATCH 1/3] New package: txt2tags-3.7

This commit adds the python3 version of txt2tags.
---
 srcpkgs/txt2tags/template | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 srcpkgs/txt2tags/template

diff --git a/srcpkgs/txt2tags/template b/srcpkgs/txt2tags/template
new file mode 100644
index 000000000000..ac72e72deaec
--- /dev/null
+++ b/srcpkgs/txt2tags/template
@@ -0,0 +1,19 @@
+# Template file for 'txt2tags'
+pkgname=txt2tags
+version=3.7
+revision=1
+build_style=python3-module
+hostmakedepends="python3 python3-setuptools"
+depends="python3"
+short_desc="Tool for converting plain text into many markup languages"
+maintainer="meator <coder64@protonmail.com>"
+license="GPL-2.0-or-later"
+homepage="https://txt2tags.org/"
+distfiles="https://github.com/txt2tags/txt2tags/archive/refs/tags/${version}.tar.gz"
+checksum=ba745fc1aa98996578afadeb325173f7032a40f161dc4f6f7a7aa08848d11d03
+
+do_check() {
+	vsed -i test/lib.py -e 's:TXT2TAGS = ".*:TXT2TAGS = "build/lib/txt2tags.py":'
+	chmod u+x build/lib/txt2tags.py
+	python3 test/run.py
+}

From 5102d03560e1e6df4d4a28021a0bb55eee2ba55c Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:06:56 +0200
Subject: [PATCH 2/3] xdgmenumaker: remove pre-generated man page

The pre-generated man page is not needed anymore, because txt2tags is in the
repo. More info at https://github.com/void-linux/void-packages/pull/14645.
---
 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 | 463 ------------------
 srcpkgs/xdgmenumaker/template                 |  11 +-
 2 files changed, 8 insertions(+), 466 deletions(-)
 delete mode 100644 srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1

diff --git a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1 b/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
deleted file mode 100644
index 2dd5519afeac..000000000000
--- a/srcpkgs/xdgmenumaker/files/1.6/xdgmenumaker.1
+++ /dev/null
@@ -1,463 +0,0 @@
-.TH "xdgmenumaker" 1 "09/16/2018" "George Vlahavas"
-
-.SH NAME
-.P
-xdgmenumaker \- generate XDG menus
-.SH SYNOPSIS
-.P
-\fBxdgmenumaker\fR [\fIOPTIONS\fR]
-.SH DESCRIPTION
-.P
-\fBxdgmenumaker\fR is a command line tool, written in python, that
-generates application menus using XDG information, by scanning
-*.desktop files in all \fI$XDG_DATA_DIRS/applications\fR directories. All
-applications are sorted according to the main categories as specified
-by
-freedesktop.org (http://standards.freedesktop.org/menu\-spec/latest/apa.html)
-.P
-The menu entries that are generated by \fBxdgmenumaker\fR are localised
-according to the running user locale settings.
-.P
-\fBxdgmenumaker\fR currently supports generating menus for:
-
-.RS
-.IP \(bu 3
-amiwm
-.IP \(bu 3
-blackbox
-.IP \(bu 3
-compizboxmenu
-.IP \(bu 3
-fluxbox
-.IP \(bu 3
-fvwm
-.IP \(bu 3
-icewm
-.IP \(bu 3
-jwm
-.IP \(bu 3
-pekwm
-.IP \(bu 3
-twm and compatible derivatives such as ctwm and vtwm
-.IP \(bu 3
-windowmaker
-.RE
-.IP
-
-.P
-\fBxdgmenumaker\fR requires \fIPython 2.7\fR or \fI3.x\fR, \fIpygtk\fR
-(for Python 2.7) or \fIpygobject\fR and \fIgobject\-instrospection\fR
-(for Python 3.x), as well as \fIpyxdg\fR. \fIPillow\fR is an optional
-dependency (used by the \fB\-\-max\-icon\-size\fR option).
-.SH OPTIONS
-
-.TP
-\fB\-f, \-\-format\fR
-specify the output format to use. Valid options are \fIamiwm\fR, \fIblackbox\fR,
-\fIcompizboxmenu\fR, \fIfluxbox\fR, \fIfvwm\fR, \fIicewm\fR, \fIjwm\fR, \fIpekwm\fR,
-\fItwm\fR and \fIwindowmaker\fR.
-Specifying the output format is mandatory.
-
-.TP
-\fB\-i, \-\-icons\fR
-enable support for icons in the menus. This option does not have any
-effect for \fIamiwm\fR, \fIblackbox\fR or \fIwindowmaker\fR menus.
-
-.TP
-\fB\-s, \-\-size\fR
-set the preferred icon size in pixels. The default size is 16. You can
-set this to any number, but it generally makes sense to use standard
-icons sizes, like 16, 22, 24, 32 etc. Obviously this has an effect only
-if the \fI\-\-icons\fR option is used. You have to be careful with the sizes
-you use; some window managers don't support large icons in the menu.
-
-.TP
-\fB\-n, \-\-no\-submenu\fR
-do not create a submenu. Instead, place the application categories menus
-in the window manager's main menu. This option does not have any effect
-for \fIwindowmaker\fR menus.
-
-.TP
-\fB\-\-max\-icon\-size\fR
-restrict the maximum size for icons to the one specified with the
-\fI\-\-size\fR option. Any icons that are larger than the specified size
-will get discarded and will not be used.
-
-.TP
-\fB\-\-no\-svg\fR
-do not use SVG icons even for the WMs that support it. Right now that
-is only JWM.
-
-.TP
-\fB\-\-pekwm\-dynamic\fR
-create dynamic menus for pekwm. If you want to have dynamically
-generated menus for pekwm you have to use this option. Do not use it if
-you want to generate static menus for pekwm. Only works with \fIpekwm\fR
-of course.
-
-.TP
-\fB\-\-twm\-titles\fR
-display menu titles in TWM menus. Naturally, only has an effect when
-used with \fItwm\fR.
-
-.SH GENERAL OPTIONS
-
-.TP
-\fB\-h\fR
-Prints a usage message briefly summarizing all command\-line options
-and exits.
-
-.SH CONFIGURATION
-.P
-The terminal emulator to be used for menu entries that state that an
-application must be launched inside a terminal, can be specified in a
-\fI~/.config/xdgmenumaker.cfg\fR configuration file. Here's an example
-specifying \fBrxvt\fR as the default terminal emulator:
-
-.nf
-[Terminal]
-terminal = rxvt
-.fi
-
-
-.P
-If no such file is present, or if no terminal is set within the file,
-xdgmenumaker will default to the one specified in the debian
-alternatives system on debian and debian\-like systems and to xterm in
-any other case.
-.P
-Setting the path to a terminal emulator in an \fIXDGMENUMAKERTERM\fR
-environment variable will override any other setting.
-.SH USAGE
-
-.TP
-\fBAmiWM\fR
-
-You can generate a menu for AmiWM, running xdgmenumaker like this:
-
-$ xdgmenumaker \-f amiwm > ~/.amiwm\-xdgmenu
-
-As AmiWM does not support including other files in its settings file,
-you'll have to copy the contents of the created file in your
-\fI~/.amiwmrc\fR. It should be possible to create a script that would
-generate the main \fI~/.amiwmrc\fR file from different "source" files, but
-I'll leave that as an exercise to the user.
-
-.TP
-\fBBlackbox\fR
-
-To generate an application menu for Blackbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu
-
-and then change your main Blackbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.blackbox/menu\fR file:
-
-[include] (~/.blackbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Blackbox Menu) {xdgmenumaker \-f blackbox > ~/.blackbox/xdg_menu}
-
-.TP
-\fBCompiz Boxmenu\fR
-
-There are two ways to have an xdg menu in compiz\-boxmenu. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and add a block of code like this inside the root \fI<menu>\fR element:
-
-.nf
-<item type="launcher">
-  <command mode2="pipe">xdgmenumaker -nif compizboxmenu</command>
-  <icon>applications-other</icon>
-  <name>Applications</name>
-</item>
-.fi
-
-
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-dropdown for new menu files or menu items. Select launcher to create a
-new launcher. Set the name of the launcher to whatever you want. This will
-be the display name for the pipe menu. Then enter in:
-
-xdgmenumaker \-nif compizboxmenu
-
-for the command entry. Click the combobox
-next to the command text box and switch that to "Pipe".
-
-\fBStatic Menus\fR
-
-Edit your \fI~/.config/compiz/boxmenu/menu.xml\fR file with your favorite text
-editor and paste the output of:
-
-$ xdgmenumaker \-if compizboxmenu
-
-into \fI~/.config/compiz/boxmenu/menu.xml\fR.
-
-Alternatively, you can also run \fBcompiz\-boxmenu\-editor\fR and click the
-button that says \fIGenerate menu entries from a pipemenu script\fR. In the dialog
-box that pops up, type in:
-
-xdgmenumaker \-if compizboxmenu
-
-to append the statically generated menu to any menu file you want.
-
-.TP
-\fBFluxbox\fR
-
-To generate an application menu for Fluxbox, you can run
-\fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu
-
-and then change your main Fluxbox menu to include this file as a
-submenu. For example, add this somewhere in your \fI~/.fluxbox/menu\fR file:
-
-[include] (~/.fluxbox/xdg_menu)
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it, without having to run the command manually
-again:
-
-[exec] (Update Fluxbox Menu) {xdgmenumaker \-f fluxbox > ~/.fluxbox/xdg_menu}
-
-.TP
-\fBFvwm\fR
-
-To generate an application menu for Fvwm, you can run \fBxdgmenumaker\fR
-like this:
-
-$ xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and then edit your main Fvwm configuration file and add a line to read
-that file:
-
-read xdgmenu
-
-and also include it somewhere in your main menu, for example:
-
-.nf
-AddToMenu MenuFvwmRoot  "Root Menu"             Title
-+                       "Applications"          Popup xdgmenu
-.fi
-
-
-You could also put the menus for individual categories in your main menu
-if you want. Just look in the ~/.fvwm/xdgmenu file for the category
-names.
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu,
-if you want to update it:
-
-+ "Update Fvwm Menu" Exec xdgmenumaker \-f fvwm > ~/.fvwm/xdgmenu
-
-and restart Fvwm to apply the changes.
-
-\fINOTE:\fR If you're going to use the \fI\-\-icons\fR option to include icons
-in your menus, you might consider using the \fI\-\-max\-icon\-size\fR
-option too. Fvwm does not resize icons in its menu and having entries
-with icons that are too big makes for funny looking menus.
-
-.TP
-\fBIceWM\fR
-
-To generate an application menu for IceWM, run \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f icewm > ~/.icewm/appmenu
-
-or if you want icons in your menu:
-
-$ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-and you can then edit your \fI~/.icewm/menu\fR file and add this line
-somewhere:
-
-include appmenu
-
-You can add the \fBxdgmenumaker\fR command as another item in your menu, if
-you want to update it, without having to run the command manually again:
-
-prog "Update Menu" _none_ xdgmenumaker \-i \-f icewm > ~/.icewm/appmenu
-
-\fINOTE:\fR If you don't request icons in the menu, or if an icon is not found
-for a certain app, the icon name in the menu for that app is set to
-"_none_". This doesn't actually set the icon for that app to none.
-IceWM menu entries should always include an icon . So, by pointing it
-to a non existing icon, you essentially set it to use no icon. If you
-actually have an icewm icon named "_none_", that one will be used instead.
-
-.TP
-\fBJWM\fR
-
-You can edit your \fI~/.jwmrc\fR file and add a line that generates the
-applications menu, like this:
-
-<Include>exec: xdgmenumaker \-n \-i \-f jwm</Include>
-
-You need to put that line somewhere in the \fIRootMenu\fR section of the
-\fI~/.jwmrc\fR file.
-
-You can update the menu with:
-
-$ jwm \-reload
-
-Or you can restart JWM and the updated menu should appear. The menu will be
-recreated every time JWM is started, restarted, or when the menu is
-reloaded with the above command. You can even add a menu item that will
-refresh the menu, like this:
-
-<Program label="Refresh Menu">jwm \-reload</Program>
-
-.TP
-\fBpekwm\fR
-
-There are two ways to have an XDG menu in pekwm. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBDynamic Menus\fR
-
-Edit your \fI~/.pekwm/menu\fR file with your favourite text editor and add
-a line like the following one in the location that you want the
-dynamically generated menu to appear:
-
-.nf
-Entry = "" { Actions = "Dynamic /usr/bin/xdgmenumaker -n -i -f pekwm --pekwm-dynamic" }
-.fi
-
-
-
-Restart pekwm and the generated menu should appear. The menu will be
-automatically generated every time you access it, so it will always be
-up to date. But since xdgmenumaker will run every time you access the
-menu, the menu might not appear instantly, especially if you are using
-an older PC.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-n \-i \-f pekwm > ~/.pekwm/appsmenu
-
-to create a file with the menu contents. Then edit your
-\fI~/.pekwm/menu\fR file to include that menu, by adding a line like the
-following, in the location that you want the menu to appear:
-
-INCLUDE = "/home/your_user_name/.pekwm/appsmenu"
-
-Restart pekwm and the generated menu should appear. The menu is static
-and if you add/remove any applications, you will have to run the
-xdgmenumaker command and restart pekwm all over again to update it. The
-advantage is that there will be no delay in displaying the menu.
-
-.TP
-\fBTWM and Derivatives\fR
-
-You can create a menu for TWM running \fBxdgmenumaker\fR like this:
-
-$ xdgmenumaker \-f twm > ~/.twm\-xdgmenu
-
-If you're using the standard TWM, then unfortunately you'll have to
-manually copy/paste the contents of the generated \fI~/.twm\-xdgmenu\fR file
-into your \fI~/.twmrc\fR manually. You could then add something like this
-to your main menu definition:
-
-.nf
-"Applications" f.menu "xdgmenu"
-.fi
-
-
-
-It could be possible to create a script that updates the menus inside
-the main \fI~/.twmrc\fR settings file, but I'll leave that as an exercise
-for the user.
-
-If you're using CTWM or VTWM, instead of manually copy/pasting the menu
-contents into your settings file, you could just add an include line
-like this:
-
-.nf
-sinclude(`/home/george/.twm-xdgmenu')
-.fi
-
-
-
-\fINote:\fR In order for this to work with VTWM, \fBvtwm\fR has to be called
-with the \fI\-m\fR switch.
-
-.TP
-\fBWindowMaker\fR
-
-There are two ways to have an XDG menu in WindowMaker. The first one,
-auto\-updates the menu, every time the menu is called. The second one,
-updates the menu only when the user wants to.
-
-\fBxdgmenumaker\fR uses utf8 encoding and localised strings by default
-and has been tested only with wmaker\-crm>=0.95.1. No idea if utf8 works
-properly with older WindowMaker versions.
-
-\fBDynamic Menus\fR
-
-Open the WindowMaker preferences tool. In the \fIApplication Menu Definition\fR
-section, add a \fIGenerated Submenu\fR in your menu, by dragging it
-in. Click on the menu item you just dragged in and in the preferences
-window, in \fICommand\fR, add:
-
-xdgmenumaker \-f windowmaker
-
-Save and close the preferences window.
-
-That command will be run every time you access that submenu, so the
-application list in there will be always up to date. The downside is
-that with running this command every time, especially if
-you are on a very old PC, it might slow things down a bit. Even then it
-is probably not anything considerable.
-
-\fBStatic Menus\fR
-
-Run:
-
-$ xdgmenumaker \-f windowmaker > ~/GNUstep/Defaults/xdg_menu
-
-Then open the WindowMaker preferences tool and in the
-\fIApplication Menu Definition\fR section, add an
-\fIExternal Submenu\fR by dragging it in your menu.
-Click on the menu item you just dragged in and in the preferences
-window, in \fIPath for Menu\fR, add the location of the menu file you just
-created:
-
-~/GNUstep/Defaults/xdg_menu
-
-You can add the above mentioned \fBxdgmenumaker\fR command as another
-item in your menu, if you want to update it, without having to run the
-command manually again.
-In the \fIApplication Menu Definition\fR section in the WindowMaker
-preferences window, add a \fIRun Program\fR item in your menu by dragging it
-your menu. Click on the menu item you just dragged in and in the
-preferences window, in \fIProgram to Run\fR, add the \fBxdgmenumaker\fR command as
-mentioned above.
-
-The downside of this method, is that the menu contents will not be
-updated when you install a new application or remove one. You will need
-to run the xdgmenumaker command every time you want the menu to be
-updated. The upside is that the menu will not be generated every time
-you access the menu. This might be a better choice for (really) older
-hardware.
-
-.SH WEBSITE
-.P
-https://github.com/gapan/xdgmenumaker
-.SH AUTHORS
-.P
-\fBxdgmenumaker\fR was written by George Vlahavas <vlahavas~at~gmail~dot~com>
-
-.\" man code generated by txt2tags 2.6. (http://txt2tags.org)
diff --git a/srcpkgs/xdgmenumaker/template b/srcpkgs/xdgmenumaker/template
index a71ccd9b3759..7dd2087bf7df 100644
--- a/srcpkgs/xdgmenumaker/template
+++ b/srcpkgs/xdgmenumaker/template
@@ -1,8 +1,9 @@
 # Template file for 'xdgmenumaker'
 pkgname=xdgmenumaker
 version=1.6
-revision=1
+revision=2
 build_style=gnu-makefile
+hostmakedepends="txt2tags"
 depends="python3-xdg python3-gobject gobject-introspection python3-Pillow"
 short_desc="Automatic menu generator for WMs, such as, fluxbox, icewm, jwm, pekwm"
 maintainer="reback00 <reback00@protonmail.com>"
@@ -12,9 +13,13 @@ distfiles="https://github.com/gapan/${pkgname}/archive/${version}.tar.gz"
 checksum=46192e7e4e25b024c0516d83e8fc2c503dd1ac8e5f8c1998d3e9e4b3cbf8919b
 python_version=3
 
+pre_build() {
+	txt2tags --target man man/xdgmenumaker.t2t
+}
+
 pre_install() {
-	# Install pre-generated man page
-	vman ${FILESDIR}/${version}/xdgmenumaker.1
+	# Install generated man page
+	vman man/xdgmenumaker.1
 	# Install README.md as documentation
 	vdoc README.md
 }

From 02347384f1d1e5d7fbb8154702e86470dd21146c Mon Sep 17 00:00:00 2001
From: meator <coder64@protonmail.com>
Date: Sat, 3 Jul 2021 16:14:32 +0200
Subject: [PATCH 3/3] grml-zsh-config: add manpage and a missing file

This commit generates the grmlzshrc(5) man page via txt2tags and adds
it to the package and adds the etc/zsh/keephack file  into the
package.
---
 srcpkgs/grml-zsh-config/template | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/srcpkgs/grml-zsh-config/template b/srcpkgs/grml-zsh-config/template
index d6661af1c3e6..9f05c0d26d06 100644
--- a/srcpkgs/grml-zsh-config/template
+++ b/srcpkgs/grml-zsh-config/template
@@ -1,8 +1,9 @@
 # Template file for 'grml-zsh-config'
 pkgname=grml-zsh-config
 version=0.19.0
-revision=1
+revision=2
 wrksrc="grml-etc-core-${version}"
+hostmakedepends="make txt2tags"
 short_desc="Grml's zsh setup"
 maintainer="Christian Poulwey <christian.poulwey@t-online.de>"
 license="GPL-2.0-only"
@@ -10,7 +11,13 @@ homepage="https://grml.org/zsh/"
 distfiles="https://github.com/grml/grml-etc-core/archive/refs/tags/v${version}.tar.gz"
 checksum=57e406c6c2d588a34b84896ba2f22811cc250d308b264499ebc870bb1ce97122
 
+pre_build() {
+	make -C doc/ grmlzshrc.5
+}
+
 do_install() {
 	vinstall etc/skel/.zshrc 0644 etc/skel
 	vinstall etc/zsh/zshrc 0644 etc/zsh
+	vinstall etc/zsh/keephack 0644 etc/zsh
+	vman doc/grmlzshrc.5
 }

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (8 preceding siblings ...)
  2021-07-09 19:23 ` [PR PATCH] [Updated] " meator
@ 2021-07-10 19:00 ` Chocimier
  2021-07-10 19:00 ` [PR PATCH] [Merged]: " Chocimier
  10 siblings, 0 replies; 12+ messages in thread
From: Chocimier @ 2021-07-10 19:00 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 191 bytes --]

New comment by Chocimier on void-packages repository

https://github.com/void-linux/void-packages/pull/31786#issuecomment-877687419

Comment:
Manpage changed minimally, it's okay to revbump.

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PR PATCH] [Merged]: Add txt2tags and change manpages of some programs
  2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
                   ` (9 preceding siblings ...)
  2021-07-10 19:00 ` Chocimier
@ 2021-07-10 19:00 ` Chocimier
  10 siblings, 0 replies; 12+ messages in thread
From: Chocimier @ 2021-07-10 19:00 UTC (permalink / raw)
  To: ml

[-- Attachment #1: Type: text/plain, Size: 2314 bytes --]

There's a merged pull request on the void-packages repository

Add txt2tags and change manpages of some programs
https://github.com/void-linux/void-packages/pull/31786

Description:
<!-- Mark items with [x] where applicable -->

#### General
- [x] This is a new package and it conforms to the [quality requirements](https://github.com/void-linux/void-packages/blob/master/Manual.md#quality-requirements)

#### Have the results of the proposed changes been tested?
- [x] I use the packages affected by the proposed changes on a regular basis and confirm this PR works for me
- [ ] I generally don't use the affected packages but briefly tested this PR

<!--
If GitHub CI cannot be used to validate the build result (for example, if the
build is likely to take several hours), make sure to
[skip CI](https://github.com/void-linux/void-packages/blob/master/CONTRIBUTING.md#continuous-integration).
When skipping CI, uncomment and fill out the following section.
Note: for builds that are likely to complete in less than 2 hours, it is not
acceptable to skip CI.
-->
#### Does it build and run successfully? 
(Please choose at least one native build and, if supported, at least one cross build. More are better.)
- [x] I built this PR locally for my native architecture, (x86_64-glibc)
- [x] I built this PR locally for these architectures (if supported. mark crossbuilds):
  - [ ] aarch64-musl
  - [x] armv7l
  - [ ] armv6l-musl
---
This pull request adds the `txt2tags` package, adds a manpage and a missing file to `grml-zsh-config` and removes the pre-generated manpage in `xdgmenumaker`.

The `txt2tag` package was supposed to be added, but [was rejected](https://github.com/void-linux/void-packages/pull/11960#discussion_r287600511) because it only had a python2 version at the time. There is a python3 version now, so I want to add it here. The `xdgmenumaker` package has to include a precompiled version of its manpage in `files/`, because the `txt2tags` package isn't in the repo (more info [here](https://github.com/void-linux/void-packages/pull/11960#issuecomment-496066069)). This pull request removes the premade manpage. And it adds the manpage of `grml-zsh-config`, which depends on `txt2tags`, into the package. It also adds the `etc/zsh/keephack` file to `grml-zsh-config`.

^ permalink raw reply	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2021-07-10 19:00 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-07-03 15:38 [PR PATCH] Add `txt2tags` and change manpages of some programs meator
2021-07-03 16:12 ` [PR PATCH] [Updated] " meator
2021-07-03 16:33 ` meator
2021-07-03 17:30 ` [PR PATCH] [Updated] " meator
2021-07-03 17:45 ` Add txt2tags " meator
2021-07-03 17:55 ` [PR REVIEW] " Chocimier
2021-07-03 18:21 ` meator
2021-07-03 18:22 ` [PR PATCH] [Updated] " meator
2021-07-04 13:48 ` meator
2021-07-09 19:23 ` [PR PATCH] [Updated] " meator
2021-07-10 19:00 ` Chocimier
2021-07-10 19:00 ` [PR PATCH] [Merged]: " Chocimier

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).