The eselect developer guide article (https://wiki.gentoo.org/wiki/Project:Eselect/Developer_guide) does not include a section on how to test an eselect module. Ulm (https://wiki.gentoo.org/wiki/User:Ulm) pointed out that it is possible to include the eselect module on ~/.eselect/modules. This is not stated neither in the developer guide (https://wiki.gentoo.org/wiki/Project:Eselect/Developer_guide) nor in the User Guide (https://wiki.gentoo.org/wiki/Project:Eselect/User_guide) I'd suggest adding a small section with something along the lines of: == Adding eselect modules manually == eselect modules can be added manually to a Gentoo system. This is specially useful when an eselect module is being developed and needs to be tested. Adding the eselect module to {{Path|~/.eselect/modules}} will make eselect aware of said module. <br> Tip: The module can be a symlink, this will avoid the need to copy and paste the module every time a change is made
As a bonus: I would also include a small section on how to write a simple eselect ebuild. I took a look at a couple of eselect ebuilds and I believe Ruby's to be a fairly simple ebuild to take notes from. Maybe Ruby's eselect ebuild can be added as an example on the wiki page itself
Created attachment 863254 [details, diff] Add subsection about module testing to developer guide I've shortened the text a little, because the developer guide addresses developers and module authors, so I want to keep it concise. Please review attached patch. We would add this to https://gitweb.gentoo.org/proj/eselect.git/tree/doc/developer-guide.txt from where the wiki page would be synced.
Looks great! Thank you so much for all of your work!
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/proj/eselect.git/commit/?id=5f3a0c3cbf4c85b69a3937b792a37ae8d95d6b8a commit 5f3a0c3cbf4c85b69a3937b792a37ae8d95d6b8a Author: Ulrich Müller <ulm@gentoo.org> AuthorDate: 2023-06-04 17:35:26 +0000 Commit: Ulrich Müller <ulm@gentoo.org> CommitDate: 2023-06-04 17:35:26 +0000 Add subsection about module testing to developer guide * doc/developer-guide.txt: Add subsection about module testing. Thanks to torsi@fi.uba.ar for the suggestion. Bug 907844. Original-author: Lemon Lime <torsi@fi.uba.ar> Closes: https://bugs.gentoo.org/907844 Signed-off-by: Ulrich Müller <ulm@gentoo.org> ChangeLog | 5 +++++ doc/developer-guide.txt | 8 ++++++++ 2 files changed, 13 insertions(+)
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=a7c3c82dab37b4ebaee8fc9f110aa86264a15b4a commit a7c3c82dab37b4ebaee8fc9f110aa86264a15b4a Author: Ulrich Müller <ulm@gentoo.org> AuthorDate: 2023-06-06 18:51:58 +0000 Commit: Ulrich Müller <ulm@gentoo.org> CommitDate: 2023-06-06 18:54:47 +0000 app-admin/eselect: add 1.4.23 Closes: https://bugs.gentoo.org/905934 Closes: https://bugs.gentoo.org/907844 Signed-off-by: Ulrich Müller <ulm@gentoo.org> app-admin/eselect/Manifest | 1 + app-admin/eselect/eselect-1.4.23.ebuild | 58 +++++++++++++++++++++++++++++++++ 2 files changed, 59 insertions(+)
