Advertisement
Guest User

Untitled

a guest
Nov 20th, 2017
34
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 37.27 KB | None | 0 0
  1. From b4974863c4061348e8e48cd1782735054326eba1 Mon Sep 17 00:00:00 2001
  2. From: Sumitra Chowdhury <chowdhury9995@gmail.com>
  3. Date: Mon, 20 Nov 2017 23:03:31 +0530
  4. Subject: [PATCH] Signed-off-by: Sumitra Chowdhury <chowdhury9995@gmail.com>
  5.  
  6. Add author
  7.  
  8. Add license
  9.  
  10. Add contributing guidelines
  11.  
  12. fixes #5
  13.  
  14. Signed-off-by: Sumitra Chowdhury chowdhury9995@gmail.com
  15. ---
  16. 0001-Create-documentation-using-Sphinx.patch | 832 +++++++++++++++++++++++++++
  17. Docs/source/about.rst | 10 +
  18. Docs/source/commit_message.rst | 31 +
  19. Docs/source/conf.py | 2 +-
  20. Docs/source/contribute.rst | 9 +
  21. Docs/source/do_your_job.rst | 47 ++
  22. Docs/source/getting_started.rst | 17 +
  23. Docs/source/index.rst | 12 +-
  24. Docs/source/license.rst | 25 +
  25. Docs/source/sending_patches.rst | 36 ++
  26. Docs/source/setting_up.rst | 68 +++
  27. 11 files changed, 1085 insertions(+), 4 deletions(-)
  28. create mode 100644 0001-Create-documentation-using-Sphinx.patch
  29. create mode 100644 Docs/source/about.rst
  30. create mode 100644 Docs/source/commit_message.rst
  31. create mode 100644 Docs/source/contribute.rst
  32. create mode 100644 Docs/source/do_your_job.rst
  33. create mode 100644 Docs/source/getting_started.rst
  34. create mode 100644 Docs/source/license.rst
  35. create mode 100644 Docs/source/sending_patches.rst
  36. create mode 100644 Docs/source/setting_up.rst
  37.  
  38. diff --git a/0001-Create-documentation-using-Sphinx.patch b/0001-Create-documentation-using-Sphinx.patch
  39. new file mode 100644
  40. index 0000000..17009c0
  41. --- /dev/null
  42. +++ b/0001-Create-documentation-using-Sphinx.patch
  43. @@ -0,0 +1,832 @@
  44. +From d280c3c3f6f9eae49e18cabdd028d90896c54ff6 Mon Sep 17 00:00:00 2001
  45. +From: Sumitra Chowdhury <chowdhury9995@gmail.com>
  46. +Date: Wed, 15 Nov 2017 22:11:17 +0530
  47. +Subject: [PATCH] Create documentation using Sphinx
  48. +
  49. +Initial commit
  50. +
  51. +fixes #2
  52. +
  53. +Signed-off-by: Sumitra Chowdhury chowdhury9995@gmail.com
  54. +---
  55. + Docs/Makefile | 216 ++++++++++++++++++++++++++++++++++++++
  56. + Docs/make.bat | 263 ++++++++++++++++++++++++++++++++++++++++++++++
  57. + Docs/source/conf.py | 283 ++++++++++++++++++++++++++++++++++++++++++++++++++
  58. + Docs/source/index.rst | 22 ++++
  59. + 4 files changed, 784 insertions(+)
  60. + create mode 100644 Docs/Makefile
  61. + create mode 100644 Docs/make.bat
  62. + create mode 100644 Docs/source/conf.py
  63. + create mode 100644 Docs/source/index.rst
  64. +
  65. +diff --git a/Docs/Makefile b/Docs/Makefile
  66. +new file mode 100644
  67. +index 0000000..66031a7
  68. +--- /dev/null
  69. ++++ b/Docs/Makefile
  70. +@@ -0,0 +1,216 @@
  71. ++# Makefile for Sphinx documentation
  72. ++#
  73. ++
  74. ++# You can set these variables from the command line.
  75. ++SPHINXOPTS =
  76. ++SPHINXBUILD = sphinx-build
  77. ++PAPER =
  78. ++BUILDDIR = build
  79. ++
  80. ++# User-friendly check for sphinx-build
  81. ++ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
  82. ++$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
  83. ++endif
  84. ++
  85. ++# Internal variables.
  86. ++PAPEROPT_a4 = -D latex_paper_size=a4
  87. ++PAPEROPT_letter = -D latex_paper_size=letter
  88. ++ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
  89. ++# the i18n builder cannot share the environment and doctrees with the others
  90. ++I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
  91. ++
  92. ++.PHONY: help
  93. ++help:
  94. ++ @echo "Please use \`make <target>' where <target> is one of"
  95. ++ @echo " html to make standalone HTML files"
  96. ++ @echo " dirhtml to make HTML files named index.html in directories"
  97. ++ @echo " singlehtml to make a single large HTML file"
  98. ++ @echo " pickle to make pickle files"
  99. ++ @echo " json to make JSON files"
  100. ++ @echo " htmlhelp to make HTML files and a HTML help project"
  101. ++ @echo " qthelp to make HTML files and a qthelp project"
  102. ++ @echo " applehelp to make an Apple Help Book"
  103. ++ @echo " devhelp to make HTML files and a Devhelp project"
  104. ++ @echo " epub to make an epub"
  105. ++ @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
  106. ++ @echo " latexpdf to make LaTeX files and run them through pdflatex"
  107. ++ @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
  108. ++ @echo " text to make text files"
  109. ++ @echo " man to make manual pages"
  110. ++ @echo " texinfo to make Texinfo files"
  111. ++ @echo " info to make Texinfo files and run them through makeinfo"
  112. ++ @echo " gettext to make PO message catalogs"
  113. ++ @echo " changes to make an overview of all changed/added/deprecated items"
  114. ++ @echo " xml to make Docutils-native XML files"
  115. ++ @echo " pseudoxml to make pseudoxml-XML files for display purposes"
  116. ++ @echo " linkcheck to check all external links for integrity"
  117. ++ @echo " doctest to run all doctests embedded in the documentation (if enabled)"
  118. ++ @echo " coverage to run coverage check of the documentation (if enabled)"
  119. ++
  120. ++.PHONY: clean
  121. ++clean:
  122. ++ rm -rf $(BUILDDIR)/*
  123. ++
  124. ++.PHONY: html
  125. ++html:
  126. ++ $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
  127. ++ @echo
  128. ++ @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
  129. ++
  130. ++.PHONY: dirhtml
  131. ++dirhtml:
  132. ++ $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
  133. ++ @echo
  134. ++ @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
  135. ++
  136. ++.PHONY: singlehtml
  137. ++singlehtml:
  138. ++ $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
  139. ++ @echo
  140. ++ @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
  141. ++
  142. ++.PHONY: pickle
  143. ++pickle:
  144. ++ $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
  145. ++ @echo
  146. ++ @echo "Build finished; now you can process the pickle files."
  147. ++
  148. ++.PHONY: json
  149. ++json:
  150. ++ $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
  151. ++ @echo
  152. ++ @echo "Build finished; now you can process the JSON files."
  153. ++
  154. ++.PHONY: htmlhelp
  155. ++htmlhelp:
  156. ++ $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
  157. ++ @echo
  158. ++ @echo "Build finished; now you can run HTML Help Workshop with the" \
  159. ++ ".hhp project file in $(BUILDDIR)/htmlhelp."
  160. ++
  161. ++.PHONY: qthelp
  162. ++qthelp:
  163. ++ $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
  164. ++ @echo
  165. ++ @echo "Build finished; now you can run "qcollectiongenerator" with the" \
  166. ++ ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
  167. ++ @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/AIRYL.qhcp"
  168. ++ @echo "To view the help file:"
  169. ++ @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/AIRYL.qhc"
  170. ++
  171. ++.PHONY: applehelp
  172. ++applehelp:
  173. ++ $(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
  174. ++ @echo
  175. ++ @echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
  176. ++ @echo "N.B. You won't be able to view it unless you put it in" \
  177. ++ "~/Library/Documentation/Help or install it in your application" \
  178. ++ "bundle."
  179. ++
  180. ++.PHONY: devhelp
  181. ++devhelp:
  182. ++ $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
  183. ++ @echo
  184. ++ @echo "Build finished."
  185. ++ @echo "To view the help file:"
  186. ++ @echo "# mkdir -p $$HOME/.local/share/devhelp/AIRYL"
  187. ++ @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/AIRYL"
  188. ++ @echo "# devhelp"
  189. ++
  190. ++.PHONY: epub
  191. ++epub:
  192. ++ $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
  193. ++ @echo
  194. ++ @echo "Build finished. The epub file is in $(BUILDDIR)/epub."
  195. ++
  196. ++.PHONY: latex
  197. ++latex:
  198. ++ $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
  199. ++ @echo
  200. ++ @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
  201. ++ @echo "Run \`make' in that directory to run these through (pdf)latex" \
  202. ++ "(use \`make latexpdf' here to do that automatically)."
  203. ++
  204. ++.PHONY: latexpdf
  205. ++latexpdf:
  206. ++ $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
  207. ++ @echo "Running LaTeX files through pdflatex..."
  208. ++ $(MAKE) -C $(BUILDDIR)/latex all-pdf
  209. ++ @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
  210. ++
  211. ++.PHONY: latexpdfja
  212. ++latexpdfja:
  213. ++ $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
  214. ++ @echo "Running LaTeX files through platex and dvipdfmx..."
  215. ++ $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
  216. ++ @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
  217. ++
  218. ++.PHONY: text
  219. ++text:
  220. ++ $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
  221. ++ @echo
  222. ++ @echo "Build finished. The text files are in $(BUILDDIR)/text."
  223. ++
  224. ++.PHONY: man
  225. ++man:
  226. ++ $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
  227. ++ @echo
  228. ++ @echo "Build finished. The manual pages are in $(BUILDDIR)/man."
  229. ++
  230. ++.PHONY: texinfo
  231. ++texinfo:
  232. ++ $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
  233. ++ @echo
  234. ++ @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
  235. ++ @echo "Run \`make' in that directory to run these through makeinfo" \
  236. ++ "(use \`make info' here to do that automatically)."
  237. ++
  238. ++.PHONY: info
  239. ++info:
  240. ++ $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
  241. ++ @echo "Running Texinfo files through makeinfo..."
  242. ++ make -C $(BUILDDIR)/texinfo info
  243. ++ @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
  244. ++
  245. ++.PHONY: gettext
  246. ++gettext:
  247. ++ $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
  248. ++ @echo
  249. ++ @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
  250. ++
  251. ++.PHONY: changes
  252. ++changes:
  253. ++ $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
  254. ++ @echo
  255. ++ @echo "The overview file is in $(BUILDDIR)/changes."
  256. ++
  257. ++.PHONY: linkcheck
  258. ++linkcheck:
  259. ++ $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
  260. ++ @echo
  261. ++ @echo "Link check complete; look for any errors in the above output " \
  262. ++ "or in $(BUILDDIR)/linkcheck/output.txt."
  263. ++
  264. ++.PHONY: doctest
  265. ++doctest:
  266. ++ $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
  267. ++ @echo "Testing of doctests in the sources finished, look at the " \
  268. ++ "results in $(BUILDDIR)/doctest/output.txt."
  269. ++
  270. ++.PHONY: coverage
  271. ++coverage:
  272. ++ $(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
  273. ++ @echo "Testing of coverage in the sources finished, look at the " \
  274. ++ "results in $(BUILDDIR)/coverage/python.txt."
  275. ++
  276. ++.PHONY: xml
  277. ++xml:
  278. ++ $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
  279. ++ @echo
  280. ++ @echo "Build finished. The XML files are in $(BUILDDIR)/xml."
  281. ++
  282. ++.PHONY: pseudoxml
  283. ++pseudoxml:
  284. ++ $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
  285. ++ @echo
  286. ++ @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
  287. +diff --git a/Docs/make.bat b/Docs/make.bat
  288. +new file mode 100644
  289. +index 0000000..3f7359e
  290. +--- /dev/null
  291. ++++ b/Docs/make.bat
  292. +@@ -0,0 +1,263 @@
  293. ++@ECHO OFF
  294. ++
  295. ++REM Command file for Sphinx documentation
  296. ++
  297. ++if "%SPHINXBUILD%" == "" (
  298. ++ set SPHINXBUILD=sphinx-build
  299. ++)
  300. ++set BUILDDIR=build
  301. ++set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% source
  302. ++set I18NSPHINXOPTS=%SPHINXOPTS% source
  303. ++if NOT "%PAPER%" == "" (
  304. ++ set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
  305. ++ set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
  306. ++)
  307. ++
  308. ++if "%1" == "" goto help
  309. ++
  310. ++if "%1" == "help" (
  311. ++ :help
  312. ++ echo.Please use `make ^<target^>` where ^<target^> is one of
  313. ++ echo. html to make standalone HTML files
  314. ++ echo. dirhtml to make HTML files named index.html in directories
  315. ++ echo. singlehtml to make a single large HTML file
  316. ++ echo. pickle to make pickle files
  317. ++ echo. json to make JSON files
  318. ++ echo. htmlhelp to make HTML files and a HTML help project
  319. ++ echo. qthelp to make HTML files and a qthelp project
  320. ++ echo. devhelp to make HTML files and a Devhelp project
  321. ++ echo. epub to make an epub
  322. ++ echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
  323. ++ echo. text to make text files
  324. ++ echo. man to make manual pages
  325. ++ echo. texinfo to make Texinfo files
  326. ++ echo. gettext to make PO message catalogs
  327. ++ echo. changes to make an overview over all changed/added/deprecated items
  328. ++ echo. xml to make Docutils-native XML files
  329. ++ echo. pseudoxml to make pseudoxml-XML files for display purposes
  330. ++ echo. linkcheck to check all external links for integrity
  331. ++ echo. doctest to run all doctests embedded in the documentation if enabled
  332. ++ echo. coverage to run coverage check of the documentation if enabled
  333. ++ goto end
  334. ++)
  335. ++
  336. ++if "%1" == "clean" (
  337. ++ for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
  338. ++ del /q /s %BUILDDIR%\*
  339. ++ goto end
  340. ++)
  341. ++
  342. ++
  343. ++REM Check if sphinx-build is available and fallback to Python version if any
  344. ++%SPHINXBUILD% 1>NUL 2>NUL
  345. ++if errorlevel 9009 goto sphinx_python
  346. ++goto sphinx_ok
  347. ++
  348. ++:sphinx_python
  349. ++
  350. ++set SPHINXBUILD=python -m sphinx.__init__
  351. ++%SPHINXBUILD% 2> nul
  352. ++if errorlevel 9009 (
  353. ++ echo.
  354. ++ echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
  355. ++ echo.installed, then set the SPHINXBUILD environment variable to point
  356. ++ echo.to the full path of the 'sphinx-build' executable. Alternatively you
  357. ++ echo.may add the Sphinx directory to PATH.
  358. ++ echo.
  359. ++ echo.If you don't have Sphinx installed, grab it from
  360. ++ echo.http://sphinx-doc.org/
  361. ++ exit /b 1
  362. ++)
  363. ++
  364. ++:sphinx_ok
  365. ++
  366. ++
  367. ++if "%1" == "html" (
  368. ++ %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
  369. ++ if errorlevel 1 exit /b 1
  370. ++ echo.
  371. ++ echo.Build finished. The HTML pages are in %BUILDDIR%/html.
  372. ++ goto end
  373. ++)
  374. ++
  375. ++if "%1" == "dirhtml" (
  376. ++ %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
  377. ++ if errorlevel 1 exit /b 1
  378. ++ echo.
  379. ++ echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
  380. ++ goto end
  381. ++)
  382. ++
  383. ++if "%1" == "singlehtml" (
  384. ++ %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
  385. ++ if errorlevel 1 exit /b 1
  386. ++ echo.
  387. ++ echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
  388. ++ goto end
  389. ++)
  390. ++
  391. ++if "%1" == "pickle" (
  392. ++ %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
  393. ++ if errorlevel 1 exit /b 1
  394. ++ echo.
  395. ++ echo.Build finished; now you can process the pickle files.
  396. ++ goto end
  397. ++)
  398. ++
  399. ++if "%1" == "json" (
  400. ++ %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
  401. ++ if errorlevel 1 exit /b 1
  402. ++ echo.
  403. ++ echo.Build finished; now you can process the JSON files.
  404. ++ goto end
  405. ++)
  406. ++
  407. ++if "%1" == "htmlhelp" (
  408. ++ %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
  409. ++ if errorlevel 1 exit /b 1
  410. ++ echo.
  411. ++ echo.Build finished; now you can run HTML Help Workshop with the ^
  412. ++.hhp project file in %BUILDDIR%/htmlhelp.
  413. ++ goto end
  414. ++)
  415. ++
  416. ++if "%1" == "qthelp" (
  417. ++ %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
  418. ++ if errorlevel 1 exit /b 1
  419. ++ echo.
  420. ++ echo.Build finished; now you can run "qcollectiongenerator" with the ^
  421. ++.qhcp project file in %BUILDDIR%/qthelp, like this:
  422. ++ echo.^> qcollectiongenerator %BUILDDIR%\qthelp\AIRYL.qhcp
  423. ++ echo.To view the help file:
  424. ++ echo.^> assistant -collectionFile %BUILDDIR%\qthelp\AIRYL.ghc
  425. ++ goto end
  426. ++)
  427. ++
  428. ++if "%1" == "devhelp" (
  429. ++ %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
  430. ++ if errorlevel 1 exit /b 1
  431. ++ echo.
  432. ++ echo.Build finished.
  433. ++ goto end
  434. ++)
  435. ++
  436. ++if "%1" == "epub" (
  437. ++ %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
  438. ++ if errorlevel 1 exit /b 1
  439. ++ echo.
  440. ++ echo.Build finished. The epub file is in %BUILDDIR%/epub.
  441. ++ goto end
  442. ++)
  443. ++
  444. ++if "%1" == "latex" (
  445. ++ %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
  446. ++ if errorlevel 1 exit /b 1
  447. ++ echo.
  448. ++ echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
  449. ++ goto end
  450. ++)
  451. ++
  452. ++if "%1" == "latexpdf" (
  453. ++ %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
  454. ++ cd %BUILDDIR%/latex
  455. ++ make all-pdf
  456. ++ cd %~dp0
  457. ++ echo.
  458. ++ echo.Build finished; the PDF files are in %BUILDDIR%/latex.
  459. ++ goto end
  460. ++)
  461. ++
  462. ++if "%1" == "latexpdfja" (
  463. ++ %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
  464. ++ cd %BUILDDIR%/latex
  465. ++ make all-pdf-ja
  466. ++ cd %~dp0
  467. ++ echo.
  468. ++ echo.Build finished; the PDF files are in %BUILDDIR%/latex.
  469. ++ goto end
  470. ++)
  471. ++
  472. ++if "%1" == "text" (
  473. ++ %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
  474. ++ if errorlevel 1 exit /b 1
  475. ++ echo.
  476. ++ echo.Build finished. The text files are in %BUILDDIR%/text.
  477. ++ goto end
  478. ++)
  479. ++
  480. ++if "%1" == "man" (
  481. ++ %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
  482. ++ if errorlevel 1 exit /b 1
  483. ++ echo.
  484. ++ echo.Build finished. The manual pages are in %BUILDDIR%/man.
  485. ++ goto end
  486. ++)
  487. ++
  488. ++if "%1" == "texinfo" (
  489. ++ %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
  490. ++ if errorlevel 1 exit /b 1
  491. ++ echo.
  492. ++ echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
  493. ++ goto end
  494. ++)
  495. ++
  496. ++if "%1" == "gettext" (
  497. ++ %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
  498. ++ if errorlevel 1 exit /b 1
  499. ++ echo.
  500. ++ echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
  501. ++ goto end
  502. ++)
  503. ++
  504. ++if "%1" == "changes" (
  505. ++ %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
  506. ++ if errorlevel 1 exit /b 1
  507. ++ echo.
  508. ++ echo.The overview file is in %BUILDDIR%/changes.
  509. ++ goto end
  510. ++)
  511. ++
  512. ++if "%1" == "linkcheck" (
  513. ++ %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
  514. ++ if errorlevel 1 exit /b 1
  515. ++ echo.
  516. ++ echo.Link check complete; look for any errors in the above output ^
  517. ++or in %BUILDDIR%/linkcheck/output.txt.
  518. ++ goto end
  519. ++)
  520. ++
  521. ++if "%1" == "doctest" (
  522. ++ %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
  523. ++ if errorlevel 1 exit /b 1
  524. ++ echo.
  525. ++ echo.Testing of doctests in the sources finished, look at the ^
  526. ++results in %BUILDDIR%/doctest/output.txt.
  527. ++ goto end
  528. ++)
  529. ++
  530. ++if "%1" == "coverage" (
  531. ++ %SPHINXBUILD% -b coverage %ALLSPHINXOPTS% %BUILDDIR%/coverage
  532. ++ if errorlevel 1 exit /b 1
  533. ++ echo.
  534. ++ echo.Testing of coverage in the sources finished, look at the ^
  535. ++results in %BUILDDIR%/coverage/python.txt.
  536. ++ goto end
  537. ++)
  538. ++
  539. ++if "%1" == "xml" (
  540. ++ %SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
  541. ++ if errorlevel 1 exit /b 1
  542. ++ echo.
  543. ++ echo.Build finished. The XML files are in %BUILDDIR%/xml.
  544. ++ goto end
  545. ++)
  546. ++
  547. ++if "%1" == "pseudoxml" (
  548. ++ %SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
  549. ++ if errorlevel 1 exit /b 1
  550. ++ echo.
  551. ++ echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
  552. ++ goto end
  553. ++)
  554. ++
  555. ++:end
  556. +diff --git a/Docs/source/conf.py b/Docs/source/conf.py
  557. +new file mode 100644
  558. +index 0000000..1a9c55c
  559. +--- /dev/null
  560. ++++ b/Docs/source/conf.py
  561. +@@ -0,0 +1,283 @@
  562. ++# -*- coding: utf-8 -*-
  563. ++#
  564. ++# AIRYL documentation build configuration file, created by
  565. ++# sphinx-quickstart on Wed Nov 15 22:10:08 2017.
  566. ++#
  567. ++# This file is execfile()d with the current directory set to its
  568. ++# containing dir.
  569. ++#
  570. ++# Note that not all possible configuration values are present in this
  571. ++# autogenerated file.
  572. ++#
  573. ++# All configuration values have a default; values that are commented out
  574. ++# serve to show the default.
  575. ++
  576. ++import sys
  577. ++import os
  578. ++
  579. ++# If extensions (or modules to document with autodoc) are in another directory,
  580. ++# add these directories to sys.path here. If the directory is relative to the
  581. ++# documentation root, use os.path.abspath to make it absolute, like shown here.
  582. ++#sys.path.insert(0, os.path.abspath('.'))
  583. ++
  584. ++# -- General configuration ------------------------------------------------
  585. ++
  586. ++# If your documentation needs a minimal Sphinx version, state it here.
  587. ++#needs_sphinx = '1.0'
  588. ++
  589. ++# Add any Sphinx extension module names here, as strings. They can be
  590. ++# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
  591. ++# ones.
  592. ++extensions = []
  593. ++
  594. ++# Add any paths that contain templates here, relative to this directory.
  595. ++templates_path = ['_templates']
  596. ++
  597. ++# The suffix(es) of source filenames.
  598. ++# You can specify multiple suffix as a list of string:
  599. ++# source_suffix = ['.rst', '.md']
  600. ++source_suffix = '.rst'
  601. ++
  602. ++# The encoding of source files.
  603. ++#source_encoding = 'utf-8-sig'
  604. ++
  605. ++# The master toctree document.
  606. ++master_doc = 'index'
  607. ++
  608. ++# General information about the project.
  609. ++project = u'AIRYL'
  610. ++copyright = u'2017, Sumitra Chowdhury, Rohit Das, Rudra Nil Basu, Debayan De'
  611. ++author = u'Sumitra Chowdhury, Rohit Das, Rudra Nil Basu, Debayan De'
  612. ++
  613. ++# The version info for the project you're documenting, acts as replacement for
  614. ++# |version| and |release|, also used in various other places throughout the
  615. ++# built documents.
  616. ++#
  617. ++# The short X.Y version.
  618. ++version = u'v1'
  619. ++# The full version, including alpha/beta/rc tags.
  620. ++release = u'v1.1'
  621. ++
  622. ++# The language for content autogenerated by Sphinx. Refer to documentation
  623. ++# for a list of supported languages.
  624. ++#
  625. ++# This is also used if you do content translation via gettext catalogs.
  626. ++# Usually you set "language" from the command line for these cases.
  627. ++language = None
  628. ++
  629. ++# There are two options for replacing |today|: either, you set today to some
  630. ++# non-false value, then it is used:
  631. ++#today = ''
  632. ++# Else, today_fmt is used as the format for a strftime call.
  633. ++#today_fmt = '%B %d, %Y'
  634. ++
  635. ++# List of patterns, relative to source directory, that match files and
  636. ++# directories to ignore when looking for source files.
  637. ++exclude_patterns = []
  638. ++
  639. ++# The reST default role (used for this markup: `text`) to use for all
  640. ++# documents.
  641. ++#default_role = None
  642. ++
  643. ++# If true, '()' will be appended to :func: etc. cross-reference text.
  644. ++#add_function_parentheses = True
  645. ++
  646. ++# If true, the current module name will be prepended to all description
  647. ++# unit titles (such as .. function::).
  648. ++#add_module_names = True
  649. ++
  650. ++# If true, sectionauthor and moduleauthor directives will be shown in the
  651. ++# output. They are ignored by default.
  652. ++#show_authors = False
  653. ++
  654. ++# The name of the Pygments (syntax highlighting) style to use.
  655. ++pygments_style = 'sphinx'
  656. ++
  657. ++# A list of ignored prefixes for module index sorting.
  658. ++#modindex_common_prefix = []
  659. ++
  660. ++# If true, keep warnings as "system message" paragraphs in the built documents.
  661. ++#keep_warnings = False
  662. ++
  663. ++# If true, `todo` and `todoList` produce output, else they produce nothing.
  664. ++todo_include_todos = False
  665. ++
  666. ++
  667. ++# -- Options for HTML output ----------------------------------------------
  668. ++
  669. ++# The theme to use for HTML and HTML Help pages. See the documentation for
  670. ++# a list of builtin themes.
  671. ++html_theme = 'alabaster'
  672. ++
  673. ++# Theme options are theme-specific and customize the look and feel of a theme
  674. ++# further. For a list of options available for each theme, see the
  675. ++# documentation.
  676. ++#html_theme_options = {}
  677. ++
  678. ++# Add any paths that contain custom themes here, relative to this directory.
  679. ++#html_theme_path = []
  680. ++
  681. ++# The name for this set of Sphinx documents. If None, it defaults to
  682. ++# "<project> v<release> documentation".
  683. ++#html_title = None
  684. ++
  685. ++# A shorter title for the navigation bar. Default is the same as html_title.
  686. ++#html_short_title = None
  687. ++
  688. ++# The name of an image file (relative to this directory) to place at the top
  689. ++# of the sidebar.
  690. ++#html_logo = None
  691. ++
  692. ++# The name of an image file (relative to this directory) to use as a favicon of
  693. ++# the docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
  694. ++# pixels large.
  695. ++#html_favicon = None
  696. ++
  697. ++# Add any paths that contain custom static files (such as style sheets) here,
  698. ++# relative to this directory. They are copied after the builtin static files,
  699. ++# so a file named "default.css" will overwrite the builtin "default.css".
  700. ++html_static_path = ['_static']
  701. ++
  702. ++# Add any extra paths that contain custom files (such as robots.txt or
  703. ++# .htaccess) here, relative to this directory. These files are copied
  704. ++# directly to the root of the documentation.
  705. ++#html_extra_path = []
  706. ++
  707. ++# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
  708. ++# using the given strftime format.
  709. ++#html_last_updated_fmt = '%b %d, %Y'
  710. ++
  711. ++# If true, SmartyPants will be used to convert quotes and dashes to
  712. ++# typographically correct entities.
  713. ++#html_use_smartypants = True
  714. ++
  715. ++# Custom sidebar templates, maps document names to template names.
  716. ++#html_sidebars = {}
  717. ++
  718. ++# Additional templates that should be rendered to pages, maps page names to
  719. ++# template names.
  720. ++#html_additional_pages = {}
  721. ++
  722. ++# If false, no module index is generated.
  723. ++#html_domain_indices = True
  724. ++
  725. ++# If false, no index is generated.
  726. ++#html_use_index = True
  727. ++
  728. ++# If true, the index is split into individual pages for each letter.
  729. ++#html_split_index = False
  730. ++
  731. ++# If true, links to the reST sources are added to the pages.
  732. ++#html_show_sourcelink = True
  733. ++
  734. ++# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
  735. ++#html_show_sphinx = True
  736. ++
  737. ++# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
  738. ++#html_show_copyright = True
  739. ++
  740. ++# If true, an OpenSearch description file will be output, and all pages will
  741. ++# contain a <link> tag referring to it. The value of this option must be the
  742. ++# base URL from which the finished HTML is served.
  743. ++#html_use_opensearch = ''
  744. ++
  745. ++# This is the file name suffix for HTML files (e.g. ".xhtml").
  746. ++#html_file_suffix = None
  747. ++
  748. ++# Language to be used for generating the HTML full-text search index.
  749. ++# Sphinx supports the following languages:
  750. ++# 'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
  751. ++# 'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
  752. ++#html_search_language = 'en'
  753. ++
  754. ++# A dictionary with options for the search language support, empty by default.
  755. ++# Now only 'ja' uses this config value
  756. ++#html_search_options = {'type': 'default'}
  757. ++
  758. ++# The name of a javascript file (relative to the configuration directory) that
  759. ++# implements a search results scorer. If empty, the default will be used.
  760. ++#html_search_scorer = 'scorer.js'
  761. ++
  762. ++# Output file base name for HTML help builder.
  763. ++htmlhelp_basename = 'AIRYLdoc'
  764. ++
  765. ++# -- Options for LaTeX output ---------------------------------------------
  766. ++
  767. ++latex_elements = {
  768. ++# The paper size ('letterpaper' or 'a4paper').
  769. ++#'papersize': 'letterpaper',
  770. ++
  771. ++# The font size ('10pt', '11pt' or '12pt').
  772. ++#'pointsize': '10pt',
  773. ++
  774. ++# Additional stuff for the LaTeX preamble.
  775. ++#'preamble': '',
  776. ++
  777. ++# Latex figure (float) alignment
  778. ++#'figure_align': 'htbp',
  779. ++}
  780. ++
  781. ++# Grouping the document tree into LaTeX files. List of tuples
  782. ++# (source start file, target name, title,
  783. ++# author, documentclass [howto, manual, or own class]).
  784. ++latex_documents = [
  785. ++ (master_doc, 'AIRYL.tex', u'AIRYL Documentation',
  786. ++ u'Sumitra Chowdhury, Rohit Das, Rudra Nil Basu, Debayan De', 'manual'),
  787. ++]
  788. ++
  789. ++# The name of an image file (relative to this directory) to place at the top of
  790. ++# the title page.
  791. ++#latex_logo = None
  792. ++
  793. ++# For "manual" documents, if this is true, then toplevel headings are parts,
  794. ++# not chapters.
  795. ++#latex_use_parts = False
  796. ++
  797. ++# If true, show page references after internal links.
  798. ++#latex_show_pagerefs = False
  799. ++
  800. ++# If true, show URL addresses after external links.
  801. ++#latex_show_urls = False
  802. ++
  803. ++# Documents to append as an appendix to all manuals.
  804. ++#latex_appendices = []
  805. ++
  806. ++# If false, no module index is generated.
  807. ++#latex_domain_indices = True
  808. ++
  809. ++
  810. ++# -- Options for manual page output ---------------------------------------
  811. ++
  812. ++# One entry per manual page. List of tuples
  813. ++# (source start file, name, description, authors, manual section).
  814. ++man_pages = [
  815. ++ (master_doc, 'airyl', u'AIRYL Documentation',
  816. ++ [author], 1)
  817. ++]
  818. ++
  819. ++# If true, show URL addresses after external links.
  820. ++#man_show_urls = False
  821. ++
  822. ++
  823. ++# -- Options for Texinfo output -------------------------------------------
  824. ++
  825. ++# Grouping the document tree into Texinfo files. List of tuples
  826. ++# (source start file, target name, title, author,
  827. ++# dir menu entry, description, category)
  828. ++texinfo_documents = [
  829. ++ (master_doc, 'AIRYL', u'AIRYL Documentation',
  830. ++ author, 'AIRYL', 'One line description of project.',
  831. ++ 'Miscellaneous'),
  832. ++]
  833. ++
  834. ++# Documents to append as an appendix to all manuals.
  835. ++#texinfo_appendices = []
  836. ++
  837. ++# If false, no module index is generated.
  838. ++#texinfo_domain_indices = True
  839. ++
  840. ++# How to display URL addresses: 'footnote', 'no', or 'inline'.
  841. ++#texinfo_show_urls = 'footnote'
  842. ++
  843. ++# If true, do not generate a @detailmenu in the "Top" node's menu.
  844. ++#texinfo_no_detailmenu = False
  845. +diff --git a/Docs/source/index.rst b/Docs/source/index.rst
  846. +new file mode 100644
  847. +index 0000000..9553456
  848. +--- /dev/null
  849. ++++ b/Docs/source/index.rst
  850. +@@ -0,0 +1,22 @@
  851. ++.. AIRYL documentation master file, created by
  852. ++ sphinx-quickstart on Wed Nov 15 22:10:08 2017.
  853. ++ You can adapt this file completely to your liking, but it should at least
  854. ++ contain the root `toctree` directive.
  855. ++
  856. ++Welcome to AIRYL's documentation!
  857. ++=================================
  858. ++
  859. ++Contents:
  860. ++
  861. ++.. toctree::
  862. ++ :maxdepth: 2
  863. ++
  864. ++
  865. ++
  866. ++Indices and tables
  867. ++==================
  868. ++
  869. ++* :ref:`genindex`
  870. ++* :ref:`modindex`
  871. ++* :ref:`search`
  872. ++
  873. +--
  874. +2.7.4
  875. +
  876. diff --git a/Docs/source/about.rst b/Docs/source/about.rst
  877. new file mode 100644
  878. index 0000000..890492b
  879. --- /dev/null
  880. +++ b/Docs/source/about.rst
  881. @@ -0,0 +1,10 @@
  882. +About
  883. +=====
  884. +
  885. +AIRYL is a chatbot using AIML
  886. +
  887. +Version : |version|
  888. +
  889. +.. toctree::
  890. + license.rst
  891. +
  892. diff --git a/Docs/source/commit_message.rst b/Docs/source/commit_message.rst
  893. new file mode 100644
  894. index 0000000..1fff94b
  895. --- /dev/null
  896. +++ b/Docs/source/commit_message.rst
  897. @@ -0,0 +1,31 @@
  898. +Commit your changes
  899. +====================
  900. +
  901. +- Commit message must be of the form
  902. +
  903. + ::
  904. +
  905. + shortlog: commit message
  906. +
  907. + commit body
  908. +
  909. + fixes #<issue_number>
  910. +
  911. + Signed-off-by: [Your name] <your email>
  912. +
  913. +
  914. + - Note: add the ``git commit --signoff`` flag while committing to get the Signed-off-by line added
  915. +
  916. +- Write proper commit messages
  917. +
  918. + | - Separate subject from body with a blank line
  919. + | - Limit the subject line to 50 characters
  920. + | - Capitalize the subject line
  921. + | - Do not end the subject line with a period
  922. + | - Use the imperative mood in the subject line
  923. + | - Wrap the body at 72 characters
  924. + | - Use the body to explain what and why vs. how
  925. +
  926. + - check this_ out for more information
  927. + .. _this: https://chris.beams.io/posts/git-commit/
  928. +
  929. diff --git a/Docs/source/conf.py b/Docs/source/conf.py
  930. index 1a9c55c..223503f 100644
  931. --- a/Docs/source/conf.py
  932. +++ b/Docs/source/conf.py
  933. @@ -107,7 +107,7 @@ todo_include_todos = False
  934.  
  935. # The theme to use for HTML and HTML Help pages. See the documentation for
  936. # a list of builtin themes.
  937. -html_theme = 'alabaster'
  938. +html_theme = 'classic'
  939.  
  940. # Theme options are theme-specific and customize the look and feel of a theme
  941. # further. For a list of options available for each theme, see the
  942. diff --git a/Docs/source/contribute.rst b/Docs/source/contribute.rst
  943. new file mode 100644
  944. index 0000000..86d9e8c
  945. --- /dev/null
  946. +++ b/Docs/source/contribute.rst
  947. @@ -0,0 +1,9 @@
  948. +Contributing Guidelines
  949. +=======================
  950. +.. toctree::
  951. + getting_started.rst
  952. + setting_up.rst
  953. + do_your_job.rst
  954. + commit_message.rst
  955. + sending_patches.rst
  956. +
  957. diff --git a/Docs/source/do_your_job.rst b/Docs/source/do_your_job.rst
  958. new file mode 100644
  959. index 0000000..19799e1
  960. --- /dev/null
  961. +++ b/Docs/source/do_your_job.rst
  962. @@ -0,0 +1,47 @@
  963. +Start working
  964. +==============
  965. +
  966. +Clone the repository to your local machine
  967. +-------------------------------------------
  968. +
  969. +.. code-block:: console
  970. +
  971. + $ git clone <remote repository-link>
  972. +
  973. +- Create a branch while working on an issue
  974. +
  975. +Create a branch
  976. +----------------
  977. +
  978. +.. code-block:: console
  979. +
  980. + $ git branch <branch-name>
  981. +
  982. +- To see which branch you are on
  983. +
  984. +.. code-block:: console
  985. +
  986. + $ git branch
  987. +
  988. +Switch branch
  989. +--------------
  990. +
  991. +.. code-block:: console
  992. +
  993. + $ git checkout <branch-name>
  994. +
  995. +- Do your work, commit changes, create a patch and send it using ``git-mail``
  996. +
  997. +- For **coding style**, follow this_
  998. +.. _this: https://google.github.io/styleguide/javaguide.html
  999. +
  1000. +Pull the changes from remote
  1001. +-----------------------------
  1002. +
  1003. +.. code-block:: console
  1004. +
  1005. + $ git pull <remote repository-link> <branch-name from which you are pulling the changes>
  1006. +
  1007. +
  1008. +
  1009. +
  1010. diff --git a/Docs/source/getting_started.rst b/Docs/source/getting_started.rst
  1011. new file mode 100644
  1012. index 0000000..20a5677
  1013. --- /dev/null
  1014. +++ b/Docs/source/getting_started.rst
  1015. @@ -0,0 +1,17 @@
  1016. +================
  1017. +Getting Started
  1018. +================
  1019. +
  1020. +Install git
  1021. +-----------
  1022. +.. code-block:: console
  1023. +
  1024. + $ sudo apt-get install git
  1025. +
  1026. +Install git-email
  1027. +-----------------
  1028. +
  1029. +.. code-block:: console
  1030. +
  1031. + $ sudo-apt-get install git-email
  1032. +
  1033. diff --git a/Docs/source/index.rst b/Docs/source/index.rst
  1034. index 9553456..7b7e938 100644
  1035. --- a/Docs/source/index.rst
  1036. +++ b/Docs/source/index.rst
  1037. @@ -2,16 +2,22 @@
  1038. sphinx-quickstart on Wed Nov 15 22:10:08 2017.
  1039. You can adapt this file completely to your liking, but it should at least
  1040. contain the root `toctree` directive.
  1041. +
  1042. +| Author : Sumitra Chowdhury
  1043. +| Contact : chowdhury9995@gmail.com
  1044.  
  1045. -Welcome to AIRYL's documentation!
  1046. -=================================
  1047. +================================
  1048. +Welcome to AIRYL's documentation
  1049. +================================
  1050.  
  1051. Contents:
  1052. +
  1053.  
  1054. .. toctree::
  1055. :maxdepth: 2
  1056.  
  1057. -
  1058. + about.rst
  1059. + contribute.rst
  1060.  
  1061. Indices and tables
  1062. ==================
  1063. diff --git a/Docs/source/license.rst b/Docs/source/license.rst
  1064. new file mode 100644
  1065. index 0000000..f8a4cad
  1066. --- /dev/null
  1067. +++ b/Docs/source/license.rst
  1068. @@ -0,0 +1,25 @@
  1069. +=========
  1070. +License
  1071. +=========
  1072. +
  1073. +MIT License
  1074. +
  1075. +Copyright (c) 2017 PhoenixRRDS
  1076. +
  1077. +Permission is hereby granted, free of charge, to any person obtaining a copy
  1078. +of this software and associated documentation files (PhoenixRRDS), to deal
  1079. +in the Software without restriction, including without limitation the rights
  1080. +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  1081. +copies of PhoenixRRDS, and to permit persons to whom PhoenixRRDS is
  1082. +furnished to do so, subject to the following conditions:
  1083. +
  1084. +The above copyright notice and this permission notice shall be included in all
  1085. +copies or substantial portions of PhoenixRRDS.
  1086. +
  1087. +PHOENIXRRDS IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  1088. +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  1089. +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  1090. +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  1091. +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  1092. +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  1093. +PHOENIXRRDS.
  1094. diff --git a/Docs/source/sending_patches.rst b/Docs/source/sending_patches.rst
  1095. new file mode 100644
  1096. index 0000000..784e5c8
  1097. --- /dev/null
  1098. +++ b/Docs/source/sending_patches.rst
  1099. @@ -0,0 +1,36 @@
  1100. +===============
  1101. +Sending Patches
  1102. +===============
  1103. +
  1104. +After making the changes in the source code follow the following steps
  1105. +
  1106. + .. code-block:: console
  1107. +
  1108. + $ git add .
  1109. +
  1110. + .. code-block:: console
  1111. +
  1112. + $ git commit --signoff
  1113. +
  1114. + - add the commit message
  1115. +
  1116. +create a patch
  1117. +-------------------
  1118. + .. code-block:: console
  1119. +
  1120. + $ git format-patch master..<branch-name>
  1121. +
  1122. + - It will create a patch(.patch) file
  1123. +
  1124. +Send the patch
  1125. +--------------
  1126. +
  1127. + .. code-block:: console
  1128. +
  1129. + - git send-mail --to <receiver's mail-id> --cc < mail-id > < name of patch file created >
  1130. +
  1131. + - **Send patches to**
  1132. +
  1133. + - rudra.nil.basu.1996@gmail.com
  1134. +
  1135. + - along with a cc to the mailing list airyl@googlegroups.com
  1136. diff --git a/Docs/source/setting_up.rst b/Docs/source/setting_up.rst
  1137. new file mode 100644
  1138. index 0000000..650611b
  1139. --- /dev/null
  1140. +++ b/Docs/source/setting_up.rst
  1141. @@ -0,0 +1,68 @@
  1142. +=====================
  1143. +Set Up
  1144. +=====================
  1145. +
  1146. +Set up git-email
  1147. +-----------------
  1148. +
  1149. +- Enable IMAP and POP
  1150. +
  1151. + - Open your mail in a browser.
  1152. + - Go to the settings > Forwarding > POP/IMAP.
  1153. + - Enable IMAP and POP.
  1154. +
  1155. +- Set up your terminal.
  1156. +
  1157. + .. code-block:: console
  1158. +
  1159. + $ git config --global sendemail.from "YOUR NAME <user@example.org>"
  1160. +
  1161. + .. code-block:: console
  1162. +
  1163. + $ git config --global sendemail.smtpserver imap.example.org
  1164. +
  1165. + - imap.example.org will be smtp.googlemail.com for gmail
  1166. +
  1167. + .. code-block:: console
  1168. +
  1169. + $ git config --global sendemail.smtpuser USER
  1170. +
  1171. + - Enter your email-id in place of USER.
  1172. +
  1173. + .. code-block:: console
  1174. +
  1175. + $ git config --global sendemail.smtpencryption tls
  1176. +
  1177. + .. code-block:: console
  1178. +
  1179. + $ git config --global sendemail.smtppass = PASS
  1180. +
  1181. + - Enter your email password in place of PASS
  1182. +
  1183. +- check you settings.
  1184. +
  1185. + .. code-block:: console
  1186. +
  1187. + $ vi ~/.gitconfig
  1188. +
  1189. + - ( It will open a new file)
  1190. + - if not available add :-
  1191. + - smtpserverport = 587
  1192. + - suppresscc = self
  1193. +
  1194. +Set up vimrc
  1195. +-------------------
  1196. +
  1197. + .. code-block:: console
  1198. +
  1199. + $ vim ~/.vimrc
  1200. +
  1201. + - It will open a new file, add below given statements to that file:-
  1202. + - set tabstop=8
  1203. + - set shiftwidth=8
  1204. + - set expandtab
  1205. +
  1206. +
  1207. +
  1208. +
  1209. +
  1210. --
  1211. 2.7.4
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement