Linux server.kiran-academy.com 3.10.0-1160.108.1.el7.x86_64 #1 SMP Thu Jan 25 16:17:31 UTC 2024 x86_64
Apache/2.4.57 (Unix) OpenSSL/1.0.2k-fips
: 194.233.91.196 | : 216.73.216.172
Cant Read [ /etc/named.conf ]
7.4.32
finalho
www.github.com/MadExploits
Terminal
AUTO ROOT
Adminer
Backdoor Destroyer
Linux Exploit
Lock Shell
Lock File
Create User
CREATE RDP
PHP Mailer
BACKCONNECT
UNLOCK SHELL
HASH IDENTIFIER
CPANEL RESET
CREATE WP USER
README
+ Create Folder
+ Create File
/
usr /
share /
doc /
varnish-5.2.1 /
html /
phk /
[ HOME SHELL ]
Name
Size
Permission
Action
10goingon50.html
18.14
KB
-rw-r--r--
VSV00001.html
13.99
KB
-rw-r--r--
autocrap.html
8.21
KB
-rw-r--r--
backends.html
11.31
KB
-rw-r--r--
barriers.html
15.07
KB
-rw-r--r--
brinch-hansens-arrows.html
7.15
KB
-rw-r--r--
dough.html
17.47
KB
-rw-r--r--
farfaraway.html
9.54
KB
-rw-r--r--
firstdesign.html
68.29
KB
-rw-r--r--
gzip.html
13.73
KB
-rw-r--r--
http20.html
20.99
KB
-rw-r--r--
index.html
7.73
KB
-rw-r--r--
ipv6suckage.html
7.34
KB
-rw-r--r--
notes.html
16.4
KB
-rw-r--r--
persistent.html
8.71
KB
-rw-r--r--
platforms.html
9.68
KB
-rw-r--r--
somethinghappened.html
10.02
KB
-rw-r--r--
spdy.html
14.55
KB
-rw-r--r--
sphinx.html
8.22
KB
-rw-r--r--
ssl.html
8.91
KB
-rw-r--r--
ssl_again.html
12.14
KB
-rw-r--r--
thatslow.html
17.6
KB
-rw-r--r--
thetoolsweworkwith.html
16.65
KB
-rw-r--r--
thoughts.html
6.14
KB
-rw-r--r--
three-zero.html
7.45
KB
-rw-r--r--
trialerror.html
9.58
KB
-rw-r--r--
varnish_does_not_hash.html
12.02
KB
-rw-r--r--
vcl_expr.html
6.86
KB
-rw-r--r--
wanton_destruction.html
8.1
KB
-rw-r--r--
Delete
Unzip
Zip
${this.title}
Close
Code Editor : sphinx.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Why Sphinx and reStructuredText ? — Varnish version 5.2.1 documentation</title> <link rel="stylesheet" href="../_static/classic.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '5.2.1', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <link rel="index" title="Index" href="../genindex.html" /> <link rel="search" title="Search" href="../search.html" /> <link rel="top" title="Varnish version 5.2.1 documentation" href="../index.html" /> <link rel="up" title="Poul-Hennings random outbursts" href="index.html" /> <link rel="next" title="Notes from the Architect" href="notes.html" /> <link rel="prev" title="Did you call them autocrap tools ?" href="autocrap.html" /> </head> <body role="document"> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > <a href="notes.html" title="Notes from the Architect" accesskey="N">next</a> |</li> <li class="right" > <a href="autocrap.html" title="Did you call them autocrap tools ?" accesskey="P">previous</a> |</li> <li class="nav-item nav-item-0"><a href="../index.html">Varnish version 5.2.1 documentation</a> »</li> <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Poul-Hennings random outbursts</a> »</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body" role="main"> <div class="section" id="why-sphinx-and-restructuredtext"> <span id="phk-sphinx"></span><h1>Why <a class="reference external" href="http://sphinx.pocoo.org/">Sphinx</a> and <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> ?<a class="headerlink" href="#why-sphinx-and-restructuredtext" title="Permalink to this headline">ΒΆ</a></h1> <p>The first school of thought on documentation, is the one we subscribe to in Varnish right now: "Documentation schmocumentation..." It does not work for anybody.</p> <p>The second school is the "Write a {La}TeX document" school, where the documentation is seen as a stand alone product, which is produced independently. This works great for PDF output, and sucks royally for HTML and TXT output.</p> <p>The third school is the "Literate programming" school, which abandons readability of <em>both</em> the program source code <em>and</em> the documentation source, which seems to be one of the best access protections one can put on the source code of either.</p> <p>The fourth school is the "DoxyGen" school, which lets a program collect a mindless list of hyperlinked variable, procedure, class and filenames, and call that "documentation".</p> <p>And the fifth school is anything that uses a fileformat that cannot be put into a version control system, because it is binary and non-diff'able. It doesn't matter if it is OpenOffice, LyX or Word, a non-diffable doc source is a no go with programmers.</p> <p>Quite frankly, none of these works very well in practice.</p> <p>One of the very central issues, is that writing documentation must not become a big and clear context-switch from programming. That precludes special graphical editors, browser-based (wiki!) formats etc.</p> <p>Yes, if you write documentation for half your workday, that works, but if you write code most of your workday, that does not work. Trust me on this, I have 25 years of experience avoiding using such tools.</p> <p>I found one project which has thought radically about the problem, and their reasoning is interesting, and quite attractive to me:</p> <ol class="arabic simple"> <li>TXT files are the lingua franca of computers, even if you are logged with TELNET using IP over Avian Carriers (Which is more widespread in Norway than you would think) you can read documentation in a .TXT format.</li> <li>TXT is the most restrictive typographical format, so rather than trying to neuter a high-level format into .TXT, it is smarter to make the .TXT the source, and reinterpret it structurally into the more capable formats.</li> </ol> <p>In other words: we are talking about the <a class="reference external" href="http://docutils.sourceforge.net/rst.html">ReStructuredText</a> of the Python project, as wrapped by the <a class="reference external" href="http://sphinx.pocoo.org/">Sphinx</a> project.</p> <p>Unless there is something I have totally failed to spot, that is going to be the new documentation platform in Varnish.</p> <p>Take a peek at the Python docs, and try pressing the "show source" link at the bottom of the left menu:</p> <p>(link to random python doc page:)</p> <blockquote> <div><a class="reference external" href="https://docs.python.org/py3k/reference/expressions.html">https://docs.python.org/py3k/reference/expressions.html</a></div></blockquote> <p>Dependency wise, that means you can edit docs with no special tools, you need python+docutils+sphinx to format HTML and a LaTex (pdflatex ?) to produce PDFs, something I only expect to happen on the project server on a regular basis.</p> <p>I can live with that, I might even rewrite the VCC scripts from Tcl to Python in that case.</p> <p>Poul-Henning, 2010-04-11</p> </div> </div> </div> </div> <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> <div class="sphinxsidebarwrapper"> <h4>Previous topic</h4> <p class="topless"><a href="autocrap.html" title="previous chapter">Did you call them <em>autocrap</em> tools ?</a></p> <h4>Next topic</h4> <p class="topless"><a href="notes.html" title="next chapter">Notes from the Architect</a></p> <div role="note" aria-label="source link"> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../_sources/phk/sphinx.txt" rel="nofollow">Show Source</a></li> </ul> </div> <div id="searchbox" style="display: none" role="search"> <h3>Quick search</h3> <form class="search" action="../search.html" method="get"> <div><input type="text" name="q" /></div> <div><input type="submit" value="Go" /></div> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" >index</a></li> <li class="right" > <a href="notes.html" title="Notes from the Architect" >next</a> |</li> <li class="right" > <a href="autocrap.html" title="Did you call them autocrap tools ?" >previous</a> |</li> <li class="nav-item nav-item-0"><a href="../index.html">Varnish version 5.2.1 documentation</a> »</li> <li class="nav-item nav-item-1"><a href="index.html" >Poul-Hennings random outbursts</a> »</li> </ul> </div> <div class="footer" role="contentinfo"> © Copyright 2010-2014, Varnish Software AS. Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9. </div> </body> </html>
Close