Grant, I know your frustration. When I got involved, there was less documentation than there is now. I have done the documentation for smart. I took what Gustavo did and expanded on it. <a href="http://labix.org/smart/howto">
http://labix.org/smart/howto</a> Unfortunately, I don't know how to add pictures well with the wiki Gustavo uses. Before I started this, the smart config options were completely undocumented. <a href="http://labix.org/smart/config-options">
http://labix.org/smart/config-options</a>  I think I drove Gustavo and company nuts asking all the questions I did. I used this <a href="http://wiki.suselinuxsupport.de/wikka.php?wakka=HowtoSmartPackageManager">http://wiki.suselinuxsupport.de/wikka.php?wakka=HowtoSmartPackageManager
</a> as my rough draft for <a href="http://labix.org/smart/howto">http://labix.org/smart/howto</a> but as you can see, it was a lot easier for me to add screen shots to wikka. <br><br>Now, personally, I think we should team up and work together. I have been wanting to compile a collection of errors, so that users can more easily see what an error is, what it means, and how to fix it. I have been wanting to add more examples, but I have been really sick lately. I am a newly diagnosed diabetic and have been having seizures as well. This makes it rather hard to keep going on the smart documentation. Also, everything is to scattered about. Like the errors. I'd have to scour the smart mailing lists, and internet forums and other mailing lists for errors and bug reports pertaining to smart. This is quite time consuming. Obviously, the smart mailing lists is the best place to start. But even that can be time consuming. 
<br><br>Get back with me, and let me know what you think. I hope that you'll work with me, and improve on the documentation.<br><br><div><span class="gmail_quote">On 5/9/07, <b class="gmail_sendername">Grant McWilliams
</b> <<a href="mailto:grantmasterflash@gmail.com">grantmasterflash@gmail.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
I hadn't thought of using Python because I don't know it as well and this certain project needs to be<br>maintainable by the company I'm consulting for after I'm done and gone, hence the shell script.<br><br>

I've spent quite a lot of time digging through what little docs there are concerning smart and I've decided<br>as soon as I'm done with my current project I'm writing exhaustive Smart documentation including examples
<br>because the frustration level has been high. There just aren't many examples on the net about this even though<br>it's getting used. I needed to install software across a secure channel which brought me to smart because of the 
<br>mention in the doc about scp being a supported protocol. No examples, no more data, nothing. I did get it to work<br>and like I said I'll be writing documentation even if it doesn't get used officially because it needs to be done.
<br><br>I don't have the time to give back in the form of coding but documentation I can find time for so that's my gift, wanted or not. :-)<br><br>Grant<br><br><div><span class="gmail_quote">On 5/9/07, <b class="gmail_sendername">

<a href="mailto:smart-request@lists.labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">smart-request@lists.labix.org</a></b> <<a href="mailto:smart-request@lists.labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
smart-request@lists.labix.org</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Send smart mailing list submissions to<br>        <a href="mailto:smart@lists.labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">smart@lists.labix.org</a><br><br>To subscribe or unsubscribe via the World Wide Web, visit
<br>        <a href="http://lists.labix.org/listinfo.cgi/smart-labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
http://lists.labix.org/listinfo.cgi/smart-labix.org</a><br>or, via email, send a message with subject or body 'help' to<br>        <a href="mailto:smart-request@lists.labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
smart-request@lists.labix.org</a><br>
<br>You can reach the person managing the list at<br>        <a href="mailto:smart-owner@lists.labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">smart-owner@lists.labix.org</a><br><br>When replying, please edit your Subject line so it is more specific
<br>than "Re: Contents of smart digest..."
<br><br><br>Today's Topics:<br><br>   1. Re: smart channel --show doesn't return proper code<br>      (Gustavo Niemeyer)<br><br><br>----------------------------------------------------------------------<br><br>Message: 1
<br>Date: Wed, 09 May 2007 19:52:22 -0300<br>From: Gustavo Niemeyer <<a href="mailto:gustavo@niemeyer.net" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">gustavo@niemeyer.net</a>><br>Subject: Re: smart channel --show doesn't return proper code
<br>To: <a href="mailto:smart@labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
smart@labix.org</a><br>Message-ID: <<a href="mailto:464250A6.1020904@niemeyer.net" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">464250A6.1020904@niemeyer.net</a>><br>Content-Type: text/plain; charset=ISO-8859-1
<br><br>Hi Grant,<br><br>> When I do smart channel --show <channelname> and the channel doesn't
<br>> exist shouldn't smart return a 1 instead of a 0? It seems to be<br>> returning 0's for everything.<br>><br>> I have  a script that checks to see if a channel has already been<br>> added and if not adds it. We're having to take the output of channel
<br>> --show and grep it instead of relying on the return code. Am I off on<br>> this or maybe not understanding why smart channel --show always<br>> returns a 0 return code?<br><br>Yep, you're right.  Many commands are not quite scripting-ready yet.
<br><br>Did you consider using Python to perform that?  Should be quite<br>simple to use Smart as a library.<br><br>--<br>Gustavo Niemeyer<br><a href="http://niemeyer.net" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
http://niemeyer.net</a><br><br><br>------------------------------
<br><br>_______________________________________________<br>Smart Package Manager mailing list<br><a href="mailto:smart@labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">smart@labix.org</a>
<br><a href="http://lists.labix.org/listinfo.cgi/smart-labix.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">http://lists.labix.org/listinfo.cgi/smart-labix.org
</a><br><br><br>End of smart Digest, Vol 21, Issue 2<br>************************************<br></blockquote></div><span class="sg"><br><br clear="all"><br>-- <br>Some people, when confronted with a problem, think "I know, I'll use Windows." 
<br>Now they have two problems.
</span></blockquote></div><br>