usage of shar command
in [Ports]
|
Prev: [new port] usage of shar command
Next: apache22 imap "ssl_onceonlyinit" error following latest upgrades
From: "Frank J. Laszlo" on 22 Jul 2010 08:00 Joe wrote: > The text as its currently exists is a long way from being clear to a > first timer. And I am talking about the new change that just went in. > > "shar `find port_dir` (note the backticks)", > > or > > "shar $(find port_dir)" > > both address the problem nicely. > > By all means go and make the correction. > The solution you've provided is not portable across shells. Also, I believe its safe to expect port developers to be at least somewhat familiar with shell scripting basics. There are other ways to contribute to the project that do not require such skills, but if we want to increase the overall quality of ports as well as existing PR's, we need to set some kind of standard. After all, it only wastes the time of the volunteers who commit the thousands of PRs when they receive poorly written ports, updates, etc. I'm not trying to attack the OP, but I wanted to voice my objection for dumbing down the handbook to the point that a 3 year old could figure it out. Regards, Frank Laszlo _______________________________________________ freebsd-ports(a)freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-ports To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"
From: Jerry on 22 Jul 2010 09:01 On Thu, 22 Jul 2010 08:00:47 -0400 Frank J. Laszlo <laszlof(a)freebsd.org> articulated: > I'm not trying to attack the OP, but I wanted to voice my objection for > dumbing down the handbook to the point that a 3 year old could figure it > out. OK, so what age should we use for the cutoff limit? By the way, age is an extremely poor basis for judging intelligence. There are 7 year olds with IQs over 150 and 25 year old imbeciles. Maybe we should put a notice on the handbook page requiring a minimum IQ level with the appropriate experience level before allowing a user to view said pages. Then again, perhaps we should just remove the handbook all together and let everyone figure it out for themselves. No dumbing down at all required. We certainly would not want to over do the 'friendly' concept. I suppose some of use, you obviously, knew it all when you started out. -- Jerry ✌ FreeBSD-Ports.user(a)seibercom.net Disclaimer: off-list followups get on-list replies or get ignored. Please do not ignore the Reply-To header. __________________________________________________________________ Women's virtue is man's greatest invention. Cornelia Otis Skinner _______________________________________________ freebsd-ports(a)freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-ports To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"
From: Janne Snabb on 22 Jul 2010 09:11 On Thu, 22 Jul 2010, Jerry wrote: > Then again, perhaps we should just remove the handbook all together and > let everyone figure it out for themselves. No dumbing down at all > required. We certainly would not want to over do the 'friendly' > concept. I suppose some of use, you obviously, knew it all when you > started out. <sarcasm> I think there should be also a comment in addition to the backticks issue that one should press ENTER key after they have successfully entered all the required characters. This way we can teach all the UNIX basics in one single document "The Porters Handbook" and will have a tremendous success attracting people to learn UNIX by submitting broken ports and asking basic questions on this mailing list. </sarcasm> PS. Flame me if you like. -- Janne Snabb / EPIPE Communications snabb(a)epipe.com - http://epipe.com/ _______________________________________________ freebsd-ports(a)freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-ports To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"
From: Chip Camden on 22 Jul 2010 10:49 Quoth Janne Snabb on Thursday, 22 July 2010: > On Thu, 22 Jul 2010, Jerry wrote: > > >Then again, perhaps we should just remove the handbook all together and > >let everyone figure it out for themselves. No dumbing down at all > >required. We certainly would not want to over do the 'friendly' > >concept. I suppose some of use, you obviously, knew it all when you > >started out. > > <sarcasm> > > I think there should be also a comment in addition to the backticks > issue that one should press ENTER key after they have successfully > entered all the required characters. This way we can teach all the > UNIX basics in one single document "The Porters Handbook" and will > have a tremendous success attracting people to learn UNIX by > submitting broken ports and asking basic questions on this mailing > list. > > </sarcasm> > > PS. Flame me if you like. > There are places to teach basic shell scripting, but the Porter's Handbook is not one of them, IMHO. Perhaps a "(note the backticks)" is appropriate for a web-based document because of potential font mangling, but I'd stick with the version of the command that's most universally applicable rather than the most readable. -- Sterling (Chip) Camden | sterling(a)camdensoftware.com | 2048D/3A978E4F http://camdensoftware.com | http://chipstips.com | http://chipsquips..com
From: Doug Barton on 22 Jul 2010 14:12
We don't support flamewars on FreeBSD lists, so I'm going to ask everyone to simply stop posting on this thread. The OP had a good point in that the PH text was not as clear as it could be. I think I've made an improvement to it, and I'm sensitive to the argument that $() is not portable, so we'll leave the text as it is for now and see how it goes. Thanks, Doug -- Improve the effectiveness of your Internet presence with a domain name makeover! http://SupersetSolutions.com/ Computers are useless. They can only give you answers. -- Pablo Picasso _______________________________________________ freebsd-ports(a)freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-ports To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org" |