Search Criteria
Package Details: automx2 2024.2-1
Package Actions
Git Clone URL: | https://aur.archlinux.org/automx2.git (read-only, click to copy) |
---|---|
Package Base: | automx2 |
Description: | Mail User Agent (email client) configuration made easy |
Upstream URL: | https://github.com/rseichter/automx2 |
Licenses: | GPL3 |
Submitter: | Morbius |
Maintainer: | Morbius |
Last Packager: | Morbius |
Votes: | 1 |
Popularity: | 0.004442 |
First Submitted: | 2024-02-19 10:25 (UTC) |
Last Updated: | 2024-08-02 06:57 (UTC) |
Dependencies (9)
- python (python37AUR, python311AUR, python310AUR)
- python-flask (python-flask-gitAUR)
- python-flask-migrate
- python-flask-sqlalchemy
- python-ldap3
- python-sqlalchemy (python-sqlalchemy1.3AUR, python-sqlalchemy-gitAUR, python-sqlalchemy1.4)
- python-build (make)
- python-installer (python-installer-gitAUR) (make)
- python-wheel (make)
Latest Comments
Morbius commented on 2024-02-20 08:05 (UTC) (edited on 2024-02-20 08:06 (UTC) by Morbius)
I didn't phrase my question clearly enough, but no matter. Future upstream releases will ship with bundled documentation, which I will then include in my AUR package.
By the way, the reason it was not previously included in automx2 releases is that locally stored docs can (and have) become stale when the online documentation changes.
m040601 commented on 2024-02-20 07:46 (UTC) (edited on 2024-02-20 08:22 (UTC) by m040601)
You are right that, in this particular case, and considering the current content of the README,
one cannot expect much from the README. Except to tell you to go online and look for help. But that is just because the tool is shipped with absolutely no man page or help flag option.
But even so, why would you through the "README" to the trash in the PKGBUILD ? It is there, it was shipped. A README , if it is there, always belongs to /usr/share/doc no matter how poor it is. These are the AUR standards.
You are already doing more than just "python setup ..." . And added extra files. You already have these 2 extra lines:
Cant you put a third one ? Something like
What do I expect when I am using a new non trivial tool ?
I expect the same as when I type "man pacman", "man pacman.conf" or "git help" or I am inside my editor and type ":he vim".
I dont have to stop, open a web browser, and look for help on the Internet. I dont have to git clone the repo to have some sort of help file.
As I said the docs are there, its just that the way he, the developer, packages everything for distribution dont include them. Forcing me to go online to read them.
It is just a matter of asking him to change a bit the Makefile and the python setup scripts for packaging.
Morbius commented on 2024-02-20 03:58 (UTC)
@m040601 This the first AUR package I have ever created, and I am grateful for suggestions regarding best practices and possible improvements. Version 2024.0 will follow, and I am also planning on adding a test stage to PKGBUILD. I wanted to keep things simple in the beginning.
As far as documentation is concerned, https://rseichter.github.io/automx2/ is the official "source of truth". What would you expect from an additional README file, seen from an Arch Linux perspective?
m040601 commented on 2024-02-20 03:39 (UTC)
Very interesting tool ! Thanks for the work providing this PKGBUILD. You even went to the trouble of adding the extra /etc/automx2/automx2.conf and the systemd service. Nice
I tested it and every thing seems to be working fine.
Reading the docs, today I finally learned how Mozilla Thunderbird and other do that autoconfiguration thing.
I didnt even know this was possible with an open source tool, that you can self host.
This avoid sending your email address to a third party. Very useful.
Two small questions about the version and docs.
github also says,
So is this PKGBUILD installing the "2022" version ? Or will you be updating to the "2024" ?
About the docs,
... sadly nothing
So the developer at least ships the README. This is important. These kind of tools need locally offline docs/man/pages/help/examples for spending the necessary time to master them.
Can you please make sure it also lands in something like,
Like you already do for the other extra files
It's a pity the developer doesnt ship more docs in the tar.gz release. They are necessary, and he does have a lot on the repo. And he writes nicely explaining a lot of concepts and background
https://github.com/rseichter/automx2
I would like to have them also shipped, and have them locally offline on my PC. I would maybe ask the developer to do so.
Thanks in advance.