From 718741b036d646197f7bd47221fb8d093f768ece Mon Sep 17 00:00:00 2001
From: wowario <wowario@protonmail.com>
Date: Tue, 30 Mar 2021 09:00:25 +0300
Subject: [PATCH] add man page

---
 HACKING.md             |  28 +++++++----
 src/assets/wowlet.1.gz | Bin 0 -> 1645 bytes
 src/assets/wowlet.1.md | 111 +++++++++++++++++++++++++++++++++++++++++
 3 files changed, 129 insertions(+), 10 deletions(-)
 create mode 100644 src/assets/wowlet.1.gz
 create mode 100644 src/assets/wowlet.1.md

diff --git a/HACKING.md b/HACKING.md
index 01e8155..6b8fe78 100644
--- a/HACKING.md
+++ b/HACKING.md
@@ -1,17 +1,25 @@
 # Documentation for developers
 
-Feather is developed primarily on Linux. It uses Qt 5.15.* and chances are that your 
+WOWlet is developed primarily on Linux. It uses Qt 5.15.* and chances are that your 
 distro's package manager has a lower version. It is therefore recommended that you install 
 Qt manually using the online installer, which can be found here: https://www.qt.io/download 
 (under open-source).
 
 ## Jetbrains Clion
 
-Feather was developed using JetBrains Clion since it integrates nicely 
+WOWlet was developed using JetBrains Clion since it integrates nicely 
 with CMake and comes with a built-in debugger. To pass CMake flags to CLion, 
 go to `File->Settings->Build->CMake`, set Build Type to `Debug` and set your 
 preferred CMake options/definitions.
 
+## Man Page
+
+There is a WOWlet's manual page, which can be accessed with: `man wowlet`
+
+If a new option is introduced, please be sure to update the options section in
+`src/assets/wowlet.1.md`, the month and year in line 3, and "manify" the document
+by running this command: `pandoc wowlet.1.md -s -t man -o wowlet.1 && gzip wowlet.1`
+
 ## Requirements
 
 ### Ubuntu/Debian
@@ -33,16 +41,16 @@ protobuf libgcrypt qrencode ccache cmake pkgconfig git
 ## CMake
 
 After installing Qt you might have a folder called `/home/$user/Qt/`. You need to pass this to CMake 
-via the `CMAKE_PREFIX_PATH` definition. For me this is:
+via the `CMAKE_PREFIX_PATH` definition.
 
 ```
--DCMAKE_PREFIX_PATH=/home/dsc/QtNew/5.15.0/gcc_64
+-DCMAKE_PREFIX_PATH=/home/$user/QtNew/5.15.0/gcc_64
 ```
 
-There are some Monero/Feather related options/definitions that you may pass:
+There are some Wownero/WOWlet related options/definitions that you may pass:
 
 - `-DXMRIG=OFF` - disable XMRig feature
-- `-DTOR_BIN=/path/to/tor` - Embed a Tor executable inside Feather
+- `-DTOR_BIN=/path/to/tor` - Embed a Tor executable inside WOWlet
 - `-DDONATE_BEG=OFF` - disable the dreaded donate requests
 
 And:
@@ -74,9 +82,9 @@ Enable debugging symbols:
 -DCMAKE_BUILD_TYPE=Debug
 ```
 
-## Feather
+## Wowlet
 
-It's best to install Tor locally as a service and start Feather with `--use-local-tor`, this 
+It's best to install Tor locally as a service and start `wowlet` with `--use-local-tor`, this 
 prevents the child process from starting up and saves time.
 
 #### Ubuntu/Debian
@@ -96,9 +104,9 @@ brew services start tor
 To skip the wizards and open a wallet directly use `--wallet-file`: 
 
 ```bash
-./feather --use-local-tor --wallet-file /home/user/Monero/wallets/bla.keys
+./wowlet --use-local-tor --wallet-file /home/user/Wownero/wallets/bla.keys
 ```
 
 It is recommended that you use `--stagenet` for development. Testnet is also possible, 
-but you'll have to provide Feather a testnet node of your own.
+but you'll have to provide Wownero a testnet node of your own.
  
diff --git a/src/assets/wowlet.1.gz b/src/assets/wowlet.1.gz
new file mode 100644
index 0000000000000000000000000000000000000000..af41738186c51178d9b241828e8adf795a405b65
GIT binary patch
literal 1645
zcmV-z29o(7iwFphLt|h719xwCY-MyVF#xq!TW{((5Pr|E81<=@AiW)FrS58_0B*4q
zl58BxR&5_bVoJ6lPHhK@v_F2wPM~nwqrFJ0isIOF{l1xTaGy@VYqVIUy2#S9+`<d5
zxJ)(AVZMbZt#XmUm3w*ZxKAgJn~dRP7S4Q<oWRK?ekQ5RmT+}(Wga$SQ*sTL?gc)e
z^m6OCYz%=nA&whGPIvzF$XCzc7cWb_;pRWg#0I?zm|+N9TP5}ogb}06Dn2b92hXiG
zF5_o-#4q|BMhOiAyYp<7MuZJxYIi^MFy6ghp&*5Y<h%!>=2c&bMrM5PKj-RIiyAgI
z4p<0@VOGt%vnlivY9Y0<o0BwykO86tvjQR7DA)QAYh8#+Ax@p|{?hvGLHpES^0Kx&
z&ZtmznQj#{Dt+NlRA|?*AS(AjeSNIH=2D@=cNX-LL)J*iD-E3lRLyG6<)Nv5qj<j*
z$Z}r`*_xOt4r;43U%{rxO%zI-)N@EMOY_9j9K^!9m^W39M@Kf%Qs2PRnu~B{q-9f8
zMfI{bl2#c%Qp@?gd1-axrh;0E7n!b57VHVEM1HLB))XCuj$f<_4H?2LN)DpYb)*0H
zJW<><Mi&C>o=iEJa>)6bm!e)70_sNALU9G6D!0d2ai#YrlJ?=>S!m0$zbH!H0iI%6
zYO$-=SB}+SPLH(eRH==Sd8^X480<FTl&dVQ`T1KTG>23{#d*&2vtzzez7kbG&2!0>
z>dMdVLAM8|G+KYVF|}~4%HPdiANkU0raRrxvbGC*cV@f~*}X|f)jTT}1rk(aieDMj
z@5@3V!P~DaYME9FO`1;V#QvG_HqkxHSkB$d!qT+0k!G(iQecJH=2uoEg$<u8k-egv
z;u2f%hiG&_9#azSxG<G~U{o9<$M(Tcjn6KEV;_a>C>%NDcW)B;gnfAF<oj#*6Mi%@
zlvwCZD*1k1m~7Bl1^m6x%KdC@X{~)RzxJj+4YI#C+Tj70S3kKI_;-18d3F5_KH-E{
zM)~%v_^T}R)1!QQKB{HQg8BhPrd&)j9g<{tLD^KpRy0nQRy))U<c%`eABtyXfqmJ+
zJ(%9LR}$kK?r;!Mr5dho;FqP=wYoV!e<`%PY3~y^6RYz!*WFiP#ecQ7hGFy&)4Orv
zxHN*3)9ma7zBzc8Ui8g{3JGR25%yw=r1%5lbFFJ1$*&Z@fdL!!ulre<;>dHInCDpP
zvY0n}@NwV3(%o`qXI@k(HiO|v^}t?hSajwaC#i#T7aJq9?DfEqT62lx*1QhjkY3~L
z%v<0L(hE_RVq?%k`0~PDeMZSyaedR~bm^YJ^>>jeGibYzG92`<YLo`ab=onQ&c)gs
z)mv%b4l02!C%orqY-K3Xk}+`TvMsZNc+ef9QmpI^XyUl~G7j{2fX6NlOf+vWwl6|)
zx=`T1gwhqLgKt!g8T9)eIY$Nro=CvH;j&0e^?|mf$e26~z02y_W)<+lDjT6HUGd#L
z_5t8hlsO7i;zP)ifKBO`;cLwbsnGux=BASk%>p>S+DI%R)WdjI=7MO!!EQr?#TvyH
zc+fJl9|T=B?dEKTN`)yhX$q-oOG>FW4J_wmOc}87Hko-b0bECMcuz-U1cL`i#^j?<
zU>y1*5;O3E5$*;_Ob62>jG1HSgU3+Yjt48?1rInKqnI!TVGI<<Bt@g>CH8`Z64nD6
z4E^bd26sJd?8FJe1bjN735q3Q&pQ9C2H`DCNIV?lqc@;FO&+YjTbcyu%eh5o9z<T8
z(BahgVu+@36fy!Py%A+Y-=h;Uavd5#5CXX;K>}>-`Tm#Ln%EC>g#p1Jy@5}_dI}z#
z5sk?(G3k7)hKL}>=l6g`WJt||{7x_#FMjBCHW~SCib8nkjJ%0=hq;{|LjvDJg4_(J
zF`1Z{5eGIMu!JVlguq=Gj+ldn8Hw-dkg%V@51B=4%194JUgBBDXab?aV_XlWj2h4|
z;Dp5S)V{i(Ipc7KuwaZHs*WtWVPFYGgu?j27&RDJ@Ov;D6Wm9NgBB?dA#fNXHcSr1
z&>sSr9OMWAx%25A35LX+hQ`W_GIEAoQDy{a;25_v4}DH;%7!D1s$CvbZqG6a^cK9)
rJvCvs!VYrJXjdl|vLXIZv2eFniZ@NhriR<!DX#MuW!~%&lnnp?&mbfd

literal 0
HcmV?d00001

diff --git a/src/assets/wowlet.1.md b/src/assets/wowlet.1.md
new file mode 100644
index 0000000..9c71054
--- /dev/null
+++ b/src/assets/wowlet.1.md
@@ -0,0 +1,111 @@
+% WOWLET(1) wowlet 1.0
+% WOWlet
+% March 2021
+
+# NAME
+
+wowlet — Lightweight Wownero Wallet  
+
+# SYNOPSIS
+
+**wowlet** [*OPTION*]  
+
+# DESCRIPTION
+
+**WOWlet** is a free, open-source Wownero desktop wallet for Linux with ports for Mac OS and Windows.  
+
+# Options
+
+**-h**, **\--help**
+
+:   Displays usage information.
+
+**-v**, **\--version**
+
+:   Displays the current version number.
+
+**\--use-local-tor**
+
+:   Use system wide installed Tor instead of the bundled.
+
+**\--tor-port**
+
+:   Port of running Tor instance.
+
+**\--debug**
+
+:   Run program in debug mode.
+
+**\--quiet**
+
+:   Limit console output.
+
+**\--use-local-tor**
+
+:   Use system wide installed Tor instead of the bundled.
+
+**\--stagenet**
+
+:   Stagenet is for development purposes only.
+
+**\--testnet**
+
+:   Testnet is for development purposes only.
+
+**\--wallet-file**
+
+:   Path to wallet keys file.
+
+**\--password**
+
+:   Wallet password (escape/quote as needed).
+
+**\--daemon-address**
+
+:   Daemon address (IPv4:port).
+
+**\--export-contacts**
+
+:   Output wallet contacts as CSV to specified path.
+
+**\--export-txhistory**
+
+:   Output wallet transaction history as CSV to specified path.
+
+**\--daemon**
+
+:   Start wowlet in the background and start a websocket server (IPv4:port).
+
+**\--daemon-password**
+
+:   Password for connecting to the wowlet websocket service.
+
+# EXAMPLES
+
+**wowlet -v | \--version**
+
+:   Displays software version and then exits.
+
+**wowlet -h | \--help**
+
+:   Displays software usage information and then exits.
+
+**wowlet \--daemon 127.0.0.1:1234 \--daemon-password "sekrit"**
+
+:   Wallet starts in the background and exposes a websocket port that you can connect to using a websocket client.
+
+# BUGS
+
+See Git Issues: <https://git.wownero.com/wowlet/wowlet/issues>  
+
+# COPYRIGHT
+
+(c) 2020-2021 The Monero Project.  
+
+License: BSD-3-clause. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  
+
+1.  Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2.  Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+3.  Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.