(1 . 7)(1 . 7)
     ..::[ The Bitcoin Foundation: V Users Manual ]::..


 Doc Version: 99994 K
 Doc Version: 99993 K
      Author: mod6
 Fingerprint: 0x027A8D7C0FB8A16643720F40721705A8B71EADAF

(44 . 16)(44 . 14)
    Graph::Easy perl library can be installed.

    Ubuntu:

    apt-get install cpanminus
    cpanm -i Graph::Easy

    Gentoo [x86-64]:

    emerge g-cpan

    [ NOTE: Copy the next nine lines exacty as they are presented here and ]
    [       then paste them into the shell.                                ]
    [ NOTE: Copy the next nine lines exactly as they are presented here and ]
    [       then paste them into the shell.                                 ]

cat <<EOF > /etc/portage/package.accept_keywords
# required by perl-gcpan/JSON-MaybeXS-1.003005::x-g-cpan
(89 . 6)(87 . 33)
    Gentoo:
    emerge wget

  [ Additional UNIX Commands Required ]:

    Recent distributions of Linux seem ship without tools that one would
    automatically imagine are included by default.  Unfortunate users have
    found this out the hard way.  You will need the following binaries
    on your system, or V will not run.  If V does not find one of these
    binaries on your system, it will report which one it can not find and exit.

    They are, as follows (instructions on `gpg` and `wget are posted above):

    gpg [GnuPG]
    wget
    cat
    echo
    ls
    mkdir
    patch
    pwd
    rm
    sha512sum
    sort
    which
    mktmp

    If you do not have one of these binaries on your system, for whatever
    reason, consult your OS documentation to determine how to install it.

  [ Install GraphViz ]:

    In addition to Graph::Easy, if you wish to have V automatically build the
(103 . 12)(128 . 18)
    etc-update [ enter -5 when prompted ]
    emerge -a graphviz [ Answer Yes at prompt ]

    NOTE: Some people have had issue with getting a proper graphviz installed,
    and subsequently no `dot` binary on their system.  It may be resolved by
    doing the following:

    emerge media-gfx/graphviz

  [ Download V Archive ]:

    Now you must obtain the V archive & signature from:

    http://thebitcoin.foundation/v/V-20170317.tar.gz
    http://thebitcoin.foundation/v/V-20170317.tar.gz.mod6.sig
    http://thebitcoin.foundation/v/V-20180222.tar.gz
    http://thebitcoin.foundation/v/V-20180222.tar.gz.mod6.sig

    Then check the PGP signatures supplied:

(117 . 11)(148 . 11)

    [ Key Fingerprint: 0x027A8D7C0FB8A16643720F40721705A8B71EADAF ]

    gpg --verify V-20170317.tar.gz.mod6.sig V-20170317.tar.gz
    gpg --verify V-20180222.tar.gz.mod6.sig V-20180222.tar.gz

    Then unpack the archive:

    tar -xf V-20170317.tar.gz
    tar -xf V-20180222.tar.gz

  [ Start V for the first time ]:

(155 . 7)(186 . 7)
0x01]: V Usage

  At this point the user has installed all of V's requirements, performed a
  lookup  of available signed mirrors, and sync'd the WoT, Patches and Seals.
  look up  of available signed mirrors, and sync'd the WoT, Patches and Seals.

  What follows are usages and definitions of V's options with examples.

(171 . 7)(202 . 7)
    The m or mirrors command is available to connect to the main V site:
    http://thebitcoin.foundation  Here, V can connect and pull the list of
    available mirrors, signed by mirror administrators with L1 trust with
    assbot and are in good standing in the WoT.  Ask mod6 about this if you
    deedbot and are in good standing in the WoT.  Ask mod6 about this if you
    want to run an authorized, signed mirror of V.

    The mirrors command takes one required argument, an output directory for the
(194 . 7)(225 . 7)
    directory) and Seals (.seals in the current working directory) directories
    by not setting the two <pdir> or <sdir> options -- only passing a mirror URL
    argument to the init command.  If the user wishes to use their own named
    directories, simply pass in those arguements in the exact order specified.
    directories, simply pass in those arguments in the exact order specified.

    Example:
    ./v.pl i http://thebitcoin.foundation
(257 . 11)(288 . 11)
    Options:
      [ finger ]

    The w or wot command will build a list of WoT entities eligable for
    The w or wot command will build a list of WoT entities eligible for
    creating seals for approved vpatches.  If a specific vpatch has not
    been signed by a WoT entity, it is considered a 'WILD' vpatch, and will be
	ignored.  A vpatch must be signed by both Co-Chairs of The Bitcoin Foundation
	to be considered approved for release.
    ignored.  A vpatch must be signed by both Co-Chairs of The Bitcoin Foundation
    to be considered approved for release.

    Example:
    ./v.pl w
(269 . 7)(300 . 6)
    ben_vulpes:4F7907942CA8B89B01E25A762AFA1A9FD2D031DA:Ben Vulpes <benkay@gmail.com>
    mircea_popescu:6160E1CAC8A3C52966FD76998A736F0E2FB7B452:Mircea Popescu (Acest articol are apriori avantajul aliteralitatii alaturi.) <office@polimedia.us>
    mod6:027A8D7C0FB8A16643720F40721705A8B71EADAF:mod6 (mod6) <modsix@gmail.com>
    punkman:F28E0095843B91CB22E7D65533588BE08B232B13:punkman
    trinque:FC66C0C5D98C42A1D4A98B6B42F9985AFAB953C4:Michael Trinque <mike@trinque.org>

    ./v.pl w finger
(277 . 7)(307 . 6)
    ben_vulpes-2AFA1A9FD2D031DA:4F7907942CA8B89B01E25A762AFA1A9FD2D031DA:Ben Vulpes <benkay@gmail.com>
    mircea_popescu-8A736F0E2FB7B452:6160E1CAC8A3C52966FD76998A736F0E2FB7B452:Mircea Popescu (Acest articol are apriori avantajul aliteralitatii alaturi.) <office@polimedia.us>
    mod6-721705A8B71EADAF:027A8D7C0FB8A16643720F40721705A8B71EADAF:mod6 (mod6) <modsix@gmail.com>
    punkman-33588BE08B232B13:F28E0095843B91CB22E7D65533588BE08B232B13:punkman
    trinque-42F9985AFAB953C4:FC66C0C5D98C42A1D4A98B6B42F9985AFAB953C4:Michael Trinque <mike@trinque.org>

  [  r | roots ]:
(298 . 8)(327 . 8)
  [  l | leafs ]:

    The l or leafs command takes no options or arguments, unless a different
    pd or patchdir is specified.  It simply traverses the vpatch directories
    contained vpatches and returns any leaf vpatches found in the topological
    pd or patchdir is specified.  It simply traverses the vpatches in the
    vpatch directory and returns any leaf vpatches found in the topological
    order.

    Examples:
(313 . 7)(342 . 7)

  [  f | flow  ]:

    The f or flow command prints a topoligical flow of vpatches based on
    The f or flow command prints a topological flow of vpatches based on
    precedence.  By default will look for the 'patches' directory in the present
    working directory of V and print the flow to stdout.

(353 . 12)(382 . 12)
      (<press_dir> <head>)

    The p or press command is available to apply vpatches up through <head> in
    topological order (see flow command) to an output directory <press_dir>.
    There are two required arguments; an output directory for applied patches
    <press_dir> and a vpatch <head> as the tip of the tree to press up through.
    By default, no output is shown; however if the user supplies `v' or
    `verbose' directly after the p or press command then the output from the
    patching applcation process will be directed to stdout.
    topological order (see press-path command) to an output directory
    <press_dir>.  There are two required arguments; an output directory for
    applied patches <press_dir> and a vpatch <head> as the tip of the tree to
    press up through.  By default, no output is shown; however if the user
    supplies `v' or `verbose' directly after the p or press command then the
    output from the patching application process will be directed to stdout.

    Example:
    ./v.pl p press_output genesis.vpatch
(382 . 12)(411 . 28)
      patching file bitcoin/src/init.cpp
      ...


    *** SEE ALSO 'press-path' ***

  [ pp | press-path ]:

    Arguments:
      (<head>)

    The pp or press-path command is available to allow the user to view (via
    stdout) the actual path to be pressed, given a <head> found in the flow.

    It is encouraged that a V user run this command before pressing to a given
    <head>.  From release 99993 forward, the flow is no longer used to calculate
    the press path from a given <head>.  Instead, with a given <head>, recurse
    all of the <head>'s antecedents and press those only.

  [ ss | sync-seals ]:

    Arguments:
      (<mirror_url> <sdir>)

    The ss or sync-seals command is avilable to allow the user to sync seal to
    The ss or sync-seals command is available to allow the user to sync seal to
    an alternative directory.  Two arguments are required; the <mirror_url>
    from which to sync and the alternative or existing seals directory <sdir>.

(400 . 7)(445 . 7)
    Arguments:
      (<mirror_url> <pdir> <vpatches>... )

    The sv or sync-vpatches command is availabe to allow the user to sync one or
    The sv or sync-vpatches command is available to allow the user to sync one or
    more individual vpatches to a alternative output directory.  Three arguments
    are required; the <mirror_url> from which to sync, the alternative or
    existing directory <pdir> and one or more <vpatches>.
(419 . 7)(464 . 7)
    Arguments:
     (<mirror_url> <pdir>)

    The sa or sync-all-vpatches command is avilable to allow the user to sync
    The sa or sync-all-vpatches command is available to allow the user to sync
    all vpatches from a given mirror to an alternative output directory.  Two
    arguments are required; the <mirror_url> from which to sync and the
    alternative or existing patches directory <pdir>.
(492 . 7)(537 . 7)
    Arguments:
      (<sha512_hash>)

    The o or origin command is avaliable to allow the user to pass a sha512
    The o or origin command is available to allow the user to pass a sha512
    hash and view where the given hash originated in the source tree.

  [  g | graph ]:
(500 . 7)(545 . 7)
    Arguments & Options:
      (<output_dotfile> [<output_svg_html_file>])

    The g or graph command is available to produce a topoligical flow graph in
    The g or graph command is available to produce a topological flow graph in
    SVG format.  The command has a required argument, the <output_dotfile>.
    The output Dot language file can be used to generate the SVG HTML output
    file with the `dot` binary.  To produce the output Dot language file, the
(510 . 7)(555 . 7)
    should be available for V to invoke and generate the SVG HTML output for
    the user automatically.  If it is not possible for the user to install
    'graphviz' on the local environment for whatever reason, the Dot language
    output file can be copied to a seperate environment where 'graphviz' can be
    output file can be copied to a separate environment where 'graphviz' can be
    installed.  A command like this is used to generate the SVG HTML output
    with the `dot` binary:  `dot -Tsvg v-graph.dot > v-graph.html`.

(530 . 7)(575 . 7)
    The v or version command simply prints the current version of V to stdout.
    This command takes no options or arguments.

  [  h | ? | help ]:
  [  h | help ]:

    The h or ? or help command will print a longer, more verbose help message
    The h or help command will print a longer, more verbose help message
    to stdout.  This command takes no options or arguments.