Since layman-2.0.0 went stable, we have seen lots and lots more confused first-time layman users who don't know how to get started using it. Could you add some usage instructions back to postinst like 1.x had, or maybe just something like: "To get started using layman, please refer to the following: http://www.gentoo.org/proj/en/overlays/userguide.xml" Thanks!
While layman does not do any elog messages for new installs, it still does do messages for new installs. With layman-2.0.0 it now has a layman-updater script that the ebuild runs. It is intelligent enough to perform any updates and changes to a users existing install to suit the new code. It is also capable of setting up a new install better than the previous versions. As such there is not as much need for setup instructions. There is only the adding of "source /var/layman/make.conf" to a users /etc/portage/make.conf or /etc/make.conf (which it also determines which is the correct file for the users installation). The source... line can now even be added before adding any overlays, unlike previous versions. If the user does not pay attention, then they will miss the messages printed during the post_install phase. One of the reasons for the elog message changes was for bug 440214. So it no longer prints the setup messages if there is an existing layman install. Since I needed a layman-updater to perform updates to a users existing system, I moved the new install messages to it as well, since it could also do more than the ebuild could (see above explanation). What I can do is add cli options to both layman and layman-updater to re-print the new user instructions, but as I said, they only need add the source... line to their make.conf, then layman -F or layman -L to fetch the overlays list, then begin adding overlays, layman -a some-overlay. perhaps: layman --setup-help here also is the messages it prints for new installs. messages = [ "You are now ready to add overlays into your system.", "", " layman -L", "", "will display a list of available overlays.", "", "Select an overlay and add it using", "", " layman -a overlay-name", "", "If this is the very first overlay you add with layman,", "you need to append the following statement to your", "%s file:" %make_conf, "", " source /var/lib/layman/make.conf", "", "If you modify the 'storage' parameter in the layman", "configuration file (/etc/layman/layman.cfg) you will", "need to adapt the path given above to the new storage", "directory.", "", ]
The --setup-help flag has been added to my github repo and will be merged with layman eventually.
Available in layman-2.2.0, closing as fixed.
