Bitcoin Forum
December 09, 2016, 12:00:46 PM *
News: To be able to use the next phase of the beta forum software, please ensure that your email address is correct/functional.
 
   Home   Help Search Donate Login Register  
Pages: [1]
  Print  
Author Topic: $man bitcoind ?  (Read 2270 times)
marcus_of_augustus
Legendary
*
Offline Offline

Activity: 2100



View Profile
June 04, 2011, 02:16:56 AM
 #1

Any plans for something like a man page for *nix?

https://en.bitcoin.it/wiki/Running_Bitcoin

All in here.


Advertised sites are not endorsed by the Bitcoin Forum. They may be unsafe, untrustworthy, or illegal in your jurisdiction. Advertise here.
error
Hero Member
*****
Offline Offline

Activity: 574



View Profile
June 04, 2011, 02:21:16 AM
 #2

Go ahead and write it. Smiley

15UFyv6kfWgq83Pp3yhXPr8rknv9m6581W
marcus_of_augustus
Legendary
*
Offline Offline

Activity: 2100



View Profile
June 04, 2011, 02:35:52 AM
 #3

Go ahead and write it. Smiley

Okay, I'll give it a go. Never done anything with creating man pages before except read them. And can't say I'm the world's expert on bitcoin functionality by a long shot but if I put something out there others can improve on it.

Any, all constructive input welcome. (I decide what's constructive until someone else takes it over).

Matt Corallo
Hero Member
*****
expert
Offline Offline

Activity: 751


View Profile
June 05, 2011, 11:43:25 AM
 #4

There is one written for the Debain package, you can just grab it from there.

Bitcoin Ubuntu PPA maintainer - donate to me personally: 1JBMattRztKDF2KRS3vhjJXA7h47NEsn2c
http://bitcoinrelaynetwork.org maintainer
PGP ID: 07DF 3E57 A548 CCFB 7530  7091 89BB B866 3E2E65CE
marcus_of_augustus
Legendary
*
Offline Offline

Activity: 2100



View Profile
June 05, 2011, 01:41:30 PM
 #5

There is one written for the Debain package, you can just grab it from there.

Thanks. Lucky I wasn't gonna start on that until tomorrow. If someone else is maintaining that one is there a reason why it isn't in with the git source?

Got a link to the Debian package source?

Matt Corallo
Hero Member
*****
expert
Offline Offline

Activity: 751


View Profile
June 05, 2011, 01:46:28 PM
 #6

http://ftp.de.debian.org/debian/pool/main/b/bitcoin/bitcoin_0.3.21~dfsg.orig.tar.gz
Folder debian/manpages

Bitcoin Ubuntu PPA maintainer - donate to me personally: 1JBMattRztKDF2KRS3vhjJXA7h47NEsn2c
http://bitcoinrelaynetwork.org maintainer
PGP ID: 07DF 3E57 A548 CCFB 7530  7091 89BB B866 3E2E65CE
marcus_of_augustus
Legendary
*
Offline Offline

Activity: 2100



View Profile
June 05, 2011, 02:07:30 PM
 #7


Nup. Nothing in that link ... any more ideas?

Matt Corallo
Hero Member
*****
expert
Offline Offline

Activity: 751


View Profile
June 05, 2011, 02:12:34 PM
 #8

Sorry, copied the wrong one http://ftp.de.debian.org/debian/pool/main/b/bitcoin/bitcoin_0.3.21~dfsg-1.debian.tar.gz should be right.

Bitcoin Ubuntu PPA maintainer - donate to me personally: 1JBMattRztKDF2KRS3vhjJXA7h47NEsn2c
http://bitcoinrelaynetwork.org maintainer
PGP ID: 07DF 3E57 A548 CCFB 7530  7091 89BB B866 3E2E65CE
marcus_of_augustus
Legendary
*
Offline Offline

Activity: 2100



View Profile
June 05, 2011, 02:23:00 PM
 #9


Thanks, that'll get me started, or finished even.

Edit: well that all looks complete on first glance. Maybe just update any changes since 0.3.19 and then where is best place for it to go for general dissemination?

Matt Corallo
Hero Member
*****
expert
Offline Offline

Activity: 751


View Profile
June 05, 2011, 04:41:06 PM
 #10

Edit: well that all looks complete on first glance. Maybe just update any changes since 0.3.19 and then where is best place for it to go for general dissemination?
Email the debian maintainer/man page author to get it updated.  Also, ask him about licensing.  I would like to see it in Bitcoin's tree, but according to the file, it is under GPL and thus incompatible with Bitcoin's MIT, and I, personally, dont really want to see one file with GPL and the rest MIT.

Bitcoin Ubuntu PPA maintainer - donate to me personally: 1JBMattRztKDF2KRS3vhjJXA7h47NEsn2c
http://bitcoinrelaynetwork.org maintainer
PGP ID: 07DF 3E57 A548 CCFB 7530  7091 89BB B866 3E2E65CE
hacim
Member
**
Offline Offline

Activity: 64


View Profile
June 08, 2011, 03:18:03 PM
 #11

I welcome any updates to the man pages for the newer versions of bitcoin that have come out since I originally wrote the current man page.

I also think it would make sense to include it in the upstream source. I'm a bit puzzled by the assertion that the GPL is incompatible with the MIT license. Its not incompatible, unless someone is thinking that they want to redistribute bitcoin, and the man page, under a more restrictive license for some purpose. Which MIT permits, but GPL does not. For what purpose would someone want to restricting users' rights?

15yns1RVpBHZ8uj8mGVUJVCyPh5ieW3FQx
error
Hero Member
*****
Offline Offline

Activity: 574



View Profile
June 08, 2011, 11:46:24 PM
 #12

GPL is also a very strange license to use for documentation.

15UFyv6kfWgq83Pp3yhXPr8rknv9m6581W
Matt Corallo
Hero Member
*****
expert
Offline Offline

Activity: 751


View Profile
June 09, 2011, 10:55:56 AM
 #13

I also think it would make sense to include it in the upstream source. I'm a bit puzzled by the assertion that the GPL is incompatible with the MIT license. Its not incompatible, unless someone is thinking that they want to redistribute bitcoin, and the man page, under a more restrictive license for some purpose. Which MIT permits, but GPL does not. For what purpose would someone want to restricting users' rights?
Sorry, I suppose I wasn't clear there. I didn't mean that its incompatible ie not possible, but that it is incompatible ie of a more restrictive license and thus wouldn't be committable to the Bitcoin repo. Without wanting to get into the intricacies of FLOSS licensing, Bitcoin is MIT for a reason, and GPL isnt committable.

Bitcoin Ubuntu PPA maintainer - donate to me personally: 1JBMattRztKDF2KRS3vhjJXA7h47NEsn2c
http://bitcoinrelaynetwork.org maintainer
PGP ID: 07DF 3E57 A548 CCFB 7530  7091 89BB B866 3E2E65CE
marcus_of_augustus
Legendary
*
Offline Offline

Activity: 2100



View Profile
June 13, 2011, 09:02:48 AM
 #14

I also think it would make sense to include it in the upstream source. I'm a bit puzzled by the assertion that the GPL is incompatible with the MIT license. Its not incompatible, unless someone is thinking that they want to redistribute bitcoin, and the man page, under a more restrictive license for some purpose. Which MIT permits, but GPL does not. For what purpose would someone want to restricting users' rights?
Sorry, I suppose I wasn't clear there. I didn't mean that its incompatible ie not possible, but that it is incompatible ie of a more restrictive license and thus wouldn't be committable to the Bitcoin repo. Without wanting to get into the intricacies of FLOSS licensing, Bitcoin is MIT for a reason, and GPL isnt committable.

Okay, so we can't use the debian man page for the main client because of "the intricacies of FLOSS licensing" , so what now?

If someone was to re-write a man page I can't see how it would be largely different from the debian man page without being wrong, I mean, how many ways can you write a man page?

So bitcoind is doomed to exist forever without a man page in the main client? Have we arrived at the ridiculous stage where writing an OSS man page is more about the licensing than informing the users of how to use the program? (That would suck).

I'll close this thread and be done with it if there isn't any ideas towards furthering the cause.

theymos
Administrator
Legendary
*
expert
Offline Offline

Activity: 2506


View Profile
June 13, 2011, 09:29:18 AM
 #15

This one is a bit outdated:
https://forum.bitcoin.org/wiki/doku.php?id=man_page

1NXYoJ5xU91Jp83XfVMHwwTUyZFK64BoAD
Basiley
Jr. Member
*
Offline Offline

Activity: 42


View Profile
June 13, 2011, 09:21:45 PM
 #16

GPL is also a very strange license to use for documentation.
why ? its used and used well.
same about hardware.
from building construction to food recipes.
M2Ys4U
Newbie
*
Offline Offline

Activity: 6


View Profile
June 15, 2011, 09:45:47 AM
 #17

GPL is also a very strange license to use for documentation.
why ? its used and used well.
same about hardware.
from building construction to food recipes.
The GFDL (GNU Free Documentation License) would be more appropriate. Here's the GNU explaination on why the GPL isn't that good for docs:

Quote
Why don't you use the GPL for manuals?

    It is possible to use the GPL for a manual, but the GNU Free Documentation License (GFDL) is much better for manuals.

    The GPL was designed for programs; it contains lots of complex clauses that are crucial for programs, but that would be cumbersome and unnecessary for a book or manual. For instance, anyone publishing the book on paper would have to either include machine-readable “source code” of the book along with each printed copy, or provide a written offer to send the “source code” later.

    Meanwhile, the GFDL has clauses that help publishers of free manuals make a profit from selling copies—cover texts, for instance. The special rules for Endorsements sections make it possible to use the GFDL for an official standard. This would permit modified versions, but they could not be labeled as “the standard”.

    Using the GFDL, we permit changes in the text of a manual that covers its technical topic. It is important to be able to change the technical parts, because people who change a program ought to change the documentation to correspond. The freedom to do this is an ethical imperative.

    Our manuals also include sections that state our political position about free software. We mark these as “invariant”, so that they cannot be changed or removed. The GFDL makes provisions for these “invariant sections”.
Stemby
Legendary
*
Offline Offline

Activity: 1960



View Profile
July 12, 2011, 11:56:12 AM
 #18

https://github.com/bitcoin/bitcoin/issues/398

“…virtual currencies, could have a substitution effect on central bank money if they become widely accepted.”
ECB Report, October 2012
Pages: [1]
  Print  
 
Jump to:  

Sponsored by , a Bitcoin-accepting VPN.
Powered by MySQL Powered by PHP Powered by SMF 1.1.19 | SMF © 2006-2009, Simple Machines Valid XHTML 1.0! Valid CSS!