[pacman-dev] documenting the base-devel split
I haven't been able to find any arch documentation (besides the mailing lists) on the splitting of base into base and base-devel groups. The main need is for people to understand the need to install the base-devel group before building packages. the makepkg man page seems like a good place for this. Jonathan 'wide-eye'
On Nov 8, 2007 1:03 PM, Jonathan <eyeswide@gmail.com> wrote:
I haven't been able to find any arch documentation (besides the mailing lists) on the splitting of base into base and base-devel groups. The main need is for people to understand the need to install the base-devel group before building packages. the makepkg man page seems like a good place for this.
That's probably a good idea - would you be willing to write it up? It's documentation so I'm sure you could probably just propose a paragraph here and I can copy-pasta it into the man page.
On Nov 8, 2007 1:08 PM, Aaron Griffin <aaronmgriffin@gmail.com> wrote:
On Nov 8, 2007 1:03 PM, Jonathan <eyeswide@gmail.com> wrote:
I haven't been able to find any arch documentation (besides the mailing lists) on the splitting of base into base and base-devel groups. The main need is for people to understand the need to install the base-devel group before building packages. the makepkg man page seems like a good place for this.
That's probably a good idea - would you be willing to write it up? It's documentation so I'm sure you could probably just propose a paragraph here and I can copy-pasta it into the man page.
Documentation in the manpages shouldn't be Arch Linux specific. -Dan
On Nov 8, 2007 1:10 PM, Dan McGee <dpmcgee@gmail.com> wrote:
On Nov 8, 2007 1:08 PM, Aaron Griffin <aaronmgriffin@gmail.com> wrote:
On Nov 8, 2007 1:03 PM, Jonathan <eyeswide@gmail.com> wrote:
I haven't been able to find any arch documentation (besides the mailing lists) on the splitting of base into base and base-devel groups. The main need is for people to understand the need to install the base-devel group before building packages. the makepkg man page seems like a good place for this.
That's probably a good idea - would you be willing to write it up? It's documentation so I'm sure you could probably just propose a paragraph here and I can copy-pasta it into the man page.
Documentation in the manpages shouldn't be Arch Linux specific.
Good catch, this is why we pay you the big bucks.
On Nov 8, 2007 4:42 PM, R. Dale Thomas <rdt@knoppmyth.net> wrote:
Aaron Griffin wrote:
On Nov 8, 2007 1:10 PM, Dan McGee <dpmcgee@gmail.com> wrote: [snip]
Documentation in the manpages shouldn't be Arch Linux specific.
Good catch, this is why we pay you the big bucks.
Well, shouldn't the man page for makepkg be Arch Specific?
Care to explain your logic? I know *for a fact* that we aren't the only people using makepkg. -Dan
Dan McGee wrote:
On Nov 8, 2007 4:42 PM, R. Dale Thomas <rdt@knoppmyth.net> wrote:
Aaron Griffin wrote:
On Nov 8, 2007 1:10 PM, Dan McGee <dpmcgee@gmail.com> wrote: [snip]
Documentation in the manpages shouldn't be Arch Linux specific. Good catch, this is why we pay you the big bucks.
Well, shouldn't the man page for makepkg be Arch Specific?
Care to explain your logic? I know *for a fact* that we aren't the only people using makepkg.
-Dan
Ok, Dan, I'll try. Makepkg is from a package produced by Arch and its developers. The man page _should_ accurately depict the usage of that program as it pertains to Arch. Makepkg is not a generic package and its man page would not be included in generic man-pages on other distro's but should be included (when man-pages are included) for Arch. Perhaps that is not 'technically' Arch specific, but it seemed to me to be so.
On Nov 8, 2007 5:27 PM, R. Dale Thomas <rdt@knoppmyth.net> wrote:
Makepkg is not a generic package and its man page would not be included in generic man-pages on other distro's
That's actually false. As Dan said, ArchLinux users are not the only ones using makepkg. Even if this weren't the case - makepkg is INTENDED to be used elsewhere. makepkg and pacman are brothers. It's hard to use pacman without makepkg and hard to use makepkg with pacman.
Aaron Griffin wrote:
On Nov 8, 2007 5:27 PM, R. Dale Thomas <rdt@knoppmyth.net> wrote:
Makepkg is not a generic package and its man page would not be included in generic man-pages on other distro's
That's actually false. As Dan said, ArchLinux users are not the only ones using makepkg.
I understood that, yes.
Even if this weren't the case - makepkg is INTENDED to be used elsewhere. makepkg and pacman are brothers. It's hard to use pacman without makepkg and hard to use makepkg with pacman.
And this too. Sorry, guys, I certainly was _not_ trying to be difficult, here. I must have gotten totally confused about the train of thought on this topic. I concede all points to Dan & Aaron.
On Thu, 08 Nov 2007 14:42:38 -0800 "R. Dale Thomas" <rdt@knoppmyth.net> wrote:
Aaron Griffin wrote:
On Nov 8, 2007 1:10 PM, Dan McGee <dpmcgee@gmail.com> wrote: [snip]
Documentation in the manpages shouldn't be Arch Linux specific.
Good catch, this is why we pay you the big bucks.
Well, shouldn't the man page for makepkg be Arch Specific?
No, because makepkg isn't designed to be Arch specific.
2007/11/8, Dan McGee <dpmcgee@gmail.com>:
On Nov 8, 2007 1:08 PM, Aaron Griffin <aaronmgriffin@gmail.com> wrote:
On Nov 8, 2007 1:03 PM, Jonathan <eyeswide@gmail.com> wrote:
I haven't been able to find any arch documentation (besides the mailing lists) on the splitting of base into base and base-devel groups. The main need is for people to understand the need to install the base-devel group before building packages. the makepkg man page seems like a good place for this.
That's probably a good idea - would you be willing to write it up? It's documentation so I'm sure you could probably just propose a paragraph here and I can copy-pasta it into the man page.
Documentation in the manpages shouldn't be Arch Linux specific.
It could be documented in our official Install Guide in Pacman section. -- Roman Kyrylych (Роман Кирилич)
2007/11/8, Dan McGee <dpmcgee@gmail.com>:
Documentation in the manpages shouldn't be Arch Linux specific.
So, what about patching it to be arch-specific when its package is built? This way you can distribute a source package that contains the general man-page, while you can get an extra "ARCH BEHAVIOR" section that's going to show up only when using the arch PKGBUILD. An alternative would be creating a new man-page||package that is clearly marked as arch-specific. In this case you can clearly separate generic and specific material, while the previous proposal can be a bit more hackish and messy. C.
On Nov 9, 2007 5:02 AM, bardo <ilbardo@gmail.com> wrote:
2007/11/8, Dan McGee <dpmcgee@gmail.com>:
Documentation in the manpages shouldn't be Arch Linux specific.
So, what about patching it to be arch-specific when its package is built? This way you can distribute a source package that contains the general man-page, while you can get an extra "ARCH BEHAVIOR" section that's going to show up only when using the arch PKGBUILD.
That's the farthest thing from elegant I've heard in this thread. Why is this such a big deal? I really don't get it. Document it on the wiki if this is a problem for you.
fyi i added an bug with a patch for the install guide. http://bugs.archlinux.org/task/8616
participants (7)
-
Aaron Griffin
-
bardo
-
Dan McGee
-
Jonathan
-
R. Dale Thomas
-
Roman Kyrylych
-
Travis Willard