Updated cpuminer opt READMEs, HowTos & FAQs (markdown)

cpuminer-opt-READMEs,-HowTos-&-FAQs.md

@@ -455,7 +455,7 @@ instructions on how to set them.
 
 
 
-## Logs
+# Logs
 
 ### Colours
 
@@ -470,21 +470,25 @@ Somes logs and fields are colour coded based on their purpose or to highlight im
 The log reports contain a wealth of data that can be used to report actual miner perforance
 and provide estimates.
 
-### Start up
+## Start up
 
 The startup messages are very important to ensure best performmance. In particular
 the features lists ensure the software is built for the CPU architecture and can
 take advantage of all the algo optimizations.
 
-`
-CPU: AMD Ryzen 7 1700 Eight-Core Processor          .
-SW built on Feb  8 2020 with GCC 7.4.0.
-CPU features:  AVX2    AES SHA
-SW features:   AVX2    AES SHA
-Algo features: AVX512 VAES
 
-Starting miner with AVX2 AES...
-`
+`CPU: AMD Ryzen 7 1700 Eight-Core Processor`
+
+`SW built on Feb  8 2020 with GCC 7.4.0`
+
+`CPU features:  AVX2    AES SHA`
+
+`SW features:   AVX2    AES SHA`
+
+`Algo features: AVX512 VAES`
+
+`Starting miner with AVX2 AES...`
+
 Line 1: CPU brand and model
 Line 2: CPU hardware extensions available
 Line 3: Hardware extensions supported by the software build.
@@ -496,7 +500,7 @@ Each provides additional CPU instructions and more complex operations. Only the
 each class is displayed although lower ranking features may also exist and be avaiable. Not all features
 have significant improvements and not all combinations are avalable in binary format for Windows.
 
-* SIMD vector support
+### SIMD vector support
       SSE2: minimum for 128 bit integer vector support, first available on Intel Core2. 
       SSSE3: Some additional instructions for 128 bit integer vectors, not very significant.
       SSE4.2: More 128 bit vector instructions, also not very significant.
@@ -505,33 +509,37 @@ have significant improvements and not all combinations are avalable in binary fo
       AVX512: a suite of seperate extensions that provide 512 bit integer vector support, first available on
               Intel Cascade Lake X HEDT CPUs.
 
-* AES encryption and decryption, aka AES_NI
+### AES encryption and decryption, aka AES_NI
      AES: basic hardware AES support performs AES operations with a single instruction, also requires SSE2,
           first available on Intel Westmere.
      VAES: Vectored AES, supports 4 parallel AES operations with a single instruction, first available on Intel
            Icelake. Also requires AVX512F.
 
-* SHA encryption and decryption, aka SHA_NI
+### SHA encryption and decryption, aka SHA_NI
       SHA supports basic SHA-256 operations with a single instruction, also requires SSE2. First available
       on Intel Goldmont but not widely avaiable until AMD Ryzen and Intel Icelake.
 
 Some other messages are displayed based on options such as stratum connection, API enabled, CPU affinity etc.
 
 
-### New stratum, block, job report
+## New stratum, block, job report
 
 This report is issued when a new job is received from the stratum server.
 If the report is also for a new block or a changed stratum difficulty the report
 will include new estimates for the new block or stratum difficulty.
 Using external data the coin can be identifed from its block number.
 
-`
-[2020-02-07 23:38:22] New block 1293839, job 1d9f, ntime 5e5c2e79
-                      lyra2rev3: lyra2v3.mine.zergpool.com:4550
-                      Diff: Net 50648, Stratum 26, Target 0.10156
-                      TTF @ 2758.00 kh/s: block 2y2d, share 2m38s
-                      Net TTF @ 1040.82 Gh/s: 3m29s
-`
+
+`[2020-02-07 23:38:22] New block 1293839, job 1d9f, ntime 5e5c2e79`
+
+`                      lyra2rev3: lyra2v3.mine.zergpool.com:4550`
+
+`                      Diff: Net 50648, Stratum 26, Target 0.10156`
+
+`                      TTF @ 2758.00 kh/s: block 2y2d, share 2m38s`
+
+`                      Net TTF @ 1040.82 Gh/s: 3m29s
+
 
 
 There are 3 forms of this report. New job is a one line report, new block and new stratum diff are up to
@@ -566,10 +574,11 @@ Line 5, only displayed in single coin pools
 
 ### Getwork new block, work report
 
-`
-[2020-02-28 10:54:02] New block 6273226, diff 118.48, ntime 5e5c2e79
-                      Miner TTF @ 3938.69 kh/s 6m11s, net TTF @ 68.24 Mh/s 2h04m
-`
+
+`[2020-02-28 10:54:02] New block 6273226, diff 118.48, ntime 5e5c2e79`
+
+`                      Miner TTF @ 3938.69 kh/s 6m11s, net TTF @ 68.24 Mh/s 2h04m`
+
 
 The getwork new block report is similar to the stratum new block log with a few differences. There is no
 stratum difficulty and no job id. "New job" is replaced with "New work". All present fields have the same
@@ -578,11 +587,11 @@ and is not an estimate. The block TTF is calculated from network hashrate and ne
 therefore considered correct. 
 
 
-### Share submitted report
+## Share submitted report
+
+
+`[2020-03-01 16:52:18] 168 Submit diff 2.4496e-07, block 440815, job 3f4a`
 
-`
-[2020-03-01 16:52:18] 168 Submit diff 2.4496e-07, block 440815, job 3f4a
-`
 
 The main purpose of the share submitted report is to timestamp the event to measure latency. It also contains
 info to help tracking.
@@ -599,14 +608,15 @@ A pool misconfiguration or a bug in cpuminer-opt. A bug is more liky wih new cod
 * The job id, stratum only, useful to troubleshoot stale shares.
 
 
-### Share result report
+## Share result report
 
 This report is generated when the pool's reply has been received acknowledging the submitted share.
 
-`
-[2020-02-07 23:59:03] 5 Accepted 5 S0 R0 B0, 400.092 sec (159ms)
-                      Diff 0.11393 (0.0853), Block 1044635, Job 1dd6
-`
+
+`[2020-02-07 23:59:03] 5 Accepted 5 S0 R0 B0, 400.092 sec (159ms)`
+
+`                      Diff 0.11393 (0.0853), Block 1044635, Job 1dd6`
+
 
 Line 1:
 
@@ -651,18 +661,25 @@ Mostly FYI except when solo mining. It is the ratio of share difficulty over net
 job was stale. This is obtained from data collected at submit time. 
 
 
-### Periodic summary report
+## Periodic summary report
+
+
+` [2020-03-01 16:49:10] scrypt: scryptn2.mine.zergpool.com:3435`
+
+`                      Periodic Report     3m45s        14m58s`
+
+`                      Share rate        9.84/min     9.68/min`
+
+`                      Hash rate         27.03h/s     29.17h/s   (22.83h/s)`
+
+`                      Lost hash rate        0h/s       .17h/s`
+
+`                      Submitted            37          145`
+
+`                      Accepted             37          144`
+
+`                      Stale                 0            1`
 
-`
- [2020-03-01 16:49:10] scrypt: scryptn2.mine.zergpool.com:3435
-                      Periodic Report     3m45s        14m58s
-                      Share rate        9.84/min     9.68/min
-                      Hash rate         27.03h/s     29.17h/s   (22.83h/s)
-                      Lost hash rate        0h/s       .17h/s
-                      Submitted            37          145
-                      Accepted             37          144
-                      Stale                 0            1
-`
 
 Generated aproximately every 5 minutes. The timing is not precise because it is an opportunistic report.
 It is produced when it is convenient in order to miminize the impact on mining.
@@ -694,7 +711,7 @@ displayed if not zero. Add this to effective hash rate for performance compariso
 
 * Lines 6+: Optional number of stale or rejected shares or solved blocks, only displayed if not zero.
 
-### CPU temperature and frequency report
+## CPU temperature and frequency report
 
 Another opportunistic report to avoid interrupting mining operation. Temperature reports are dsplayed more
 frequently at higher or rising temperatures and colour coded to draw attention.