Skip to content

Commit aaa7878

Browse files
committed
deltacode documentation from Aboutcode
Signed-off-by: Pratik Dey <pratikrocks.dey11@gmail.com>
1 parent 6b5106d commit aaa7878

9 files changed

Lines changed: 754 additions & 18 deletions

File tree

docs/source/conf.py

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@
1616

1717

1818
# -- Project information -----------------------------------------------------
19-
2019
project = 'deltacode'
2120
copyright = 'nexb Inc.'
2221
author = 'nexb Inc.'
@@ -49,7 +48,7 @@
4948
# Add any paths that contain custom static files (such as style sheets) here,
5049
# relative to this directory. They are copied after the builtin static files,
5150
# so a file named "default.css" will overwrite the builtin "default.css".
52-
html_static_path = ['_static']
51+
html_static_path = []
5352

5453
html_context = {
5554
'css_files': [
Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
Comprehensive Installation
2+
==========================
3+
4+
DeltaCode requires Python 2.7.x and is tested on Linux, Mac, and Windows. Make sure Python 2.7 is
5+
installed first.
6+
7+
System Requirements
8+
-------------------
9+
10+
- Hardware : DeltaCode will run best with a modern X86 processor and at least 1GB of RAM and 250MB
11+
of disk.
12+
13+
- Supported operating systems : DeltaCode should run on these OSes:
14+
15+
#. Linux: on most recent 64-bit Linux distributions (32-bit distros are only partially
16+
supported),
17+
#. Mac: on recent Mac OSX (10.6.8 and up),
18+
#. Windows: on Windows 7 and up (32- or 64-bit) using a 32-bit Python.
19+
20+
Prerequisites
21+
-------------
22+
23+
DeltaCode needs a Python 2.7 interpreter.
24+
25+
- **On Linux**:
26+
27+
Use your package manager to install ``python2.7``. If Python 2.7 is not available from your
28+
package manager, you must compile it from sources.
29+
30+
For instance, visit https://github.com/dejacode/about-code-tool/wiki/BuildingPython27OnCentos6
31+
for instructions to compile Python from sources on Centos.
32+
33+
- **On Windows**:
34+
35+
Use the Python 2.7 32-bit (e.g. the Windows x86 MSI installer) for X86 regardless of whether
36+
you run Windows on 32-bit or 64-bit. **DO NOT USE Python X86_64 installer** even if you run
37+
64 bit Windows.
38+
39+
Download Python from this url:
40+
https://www.python.org/ftp/python/2.7.14/python-2.7.14.msi
41+
42+
Install Python on the c: drive and use all default installer options.
43+
See the Windows installation section for more installation details.
44+
45+
- **On Mac**:
46+
47+
Download and install Python from this url:
48+
49+
https://www.python.org/ftp/python/2.7.14/python-2.7.14-macosx10.6.pkg
50+
51+
Installation on Linux and Mac
52+
-----------------------------
53+
54+
Download and extract the latest ScanCode release from:
55+
https://github.com/nexB/deltacode/releases/latest
56+
57+
Open a terminal in the extracted directory and run::
58+
59+
./deltacode --help
60+
61+
This will configure DeltaCode and display the command line help.
62+
63+
Installation on Windows
64+
-----------------------
65+
66+
Download the latest ScanCode release zip file from:
67+
https://github.com/nexB/deltacode/releases/latest
68+
69+
- In Windows Explorer, select the downloaded DeltaCode zip and right-click.
70+
71+
- In the pop-up menu select 'Extract All...'
72+
73+
- In the pop-up window 'Extract zip folders' use the default options to extract.
74+
75+
- Once the extraction is complete, a new Windows Explorer window will pop-up.
76+
77+
- In this Explorer window, select the new folder that was created and right-click.
78+
79+
- In the pop-up menu select 'Properties'
80+
81+
- In the pop-up window 'Properties', select the Location value. Copy this in clipboard.
82+
83+
- Press the start menu button.
84+
85+
- In the search box type
86+
87+
::
88+
89+
cmd
90+
91+
- Select 'cmd.exe' listed in the search results.
92+
93+
- A new 'cmd.exe' window pops-up.
94+
95+
- In this window (aka. a command prompt), type this (this is 'cd' followed by a space)
96+
97+
::
98+
99+
cd
100+
101+
- then right-click in this window and select Paste. This will paste the path where you extracted
102+
DeltaCode.
103+
104+
- Press Enter.
105+
106+
- This will change the current location of your command prompt to the root directory where
107+
DeltaCode is installed.
108+
109+
- Then type
110+
111+
::
112+
113+
deltacode --help
114+
115+
- Press enter. This will configure your DeltaCode installation.
116+
117+
- Several messages are displayed followed by the deltacode command help.
118+
119+
- The installation is complete.
120+
121+
Un-installation
122+
---------------
123+
124+
- Delete the directory in which you extracted DeltaCode.
125+
- Delete any temporary files created in your system temp directory under a deltacode directory.

0 commit comments

Comments
 (0)