indrajith/RCBASIC4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

generated docs added

Browse Source
This commit is contained in:
n00b
2024-10-24 23:25:02 -04:00
parent b14019f9a9
commit 6edb1bc09d
939 changed files with 88629 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

131
doc/doc_files/setup.html Normal file
View File

@@ -0,0 +1,131 @@
<!DOCTYPE html>
<html>
<head>
<style>
table, th, td { border: 1px solid black; } th, td { padding: 10px; }
body { background-color: #064066; color: #FFFFFF; }
a { color: #40bfb8; }
a::before {
content: "---";
font-family: monospace, monospace;
display: inline-block;
margin-right: 6px;
color: #064066;
}
.rc_number { color: #0b9898; }
.rc_string { color: #dd4040; }
.rc_keyword { color: #6084a8; font-weight: bold; }
.rc_comment { color: #6e716e; }
#rc_code { font-family: Consolas,"courier new"; background-color: #2d3335; padding: 2px; font-size: 105%; }
ul, #myUL {
list-style-type: none;
}
#myUL {
margin: 0;
padding: 0;
}
.box {
cursor: pointer;
-webkit-user-select: none; /* Safari 3.1+ */
-moz-user-select: none; /* Firefox 2+ */
-ms-user-select: none; /* IE 10+ */
user-select: none;
}
.box::before {
content: "[+]";
font-family: monospace, monospace;
font-weight: bold;
color: #40bfb8;
display: inline-block;
margin-right: 6px;
}
.box {
font-weight: bold;
color: #40bfb8;
text-decoration: underline;
}
.check-box::before {
content: "[-]";
font-family: monospace, monospace;
font-weight: bold;
//color: dodgerblue;
color: #40bfb8;
}
.nested {
display: none;
}
.active {
display: block;
}
</style>
<meta content="text/html; charset=UTF-8" http-equiv="content-type">
<title>RCBasic Setup [RCBasic Doc] </title>
</head>
<body>
<p><h1>[arg]</h1></p>
<p>
<h1><b><u>SETTING UP RCBASIC</u></b></h1>
</p>
<p>
RCBasic comes with 2 command-line tools for creating programs. The first is rcbasic_build which takes your sourcecode in your *.bas file and compiles it into a *.cbc file. The *.cbc file contains intermediate bytecode which can be ran with the rcbasic (rcbasic.exe on windows) application.
</p>
<p>
NOTE: On Windows, you need to include all the 32-bit dlls with the 32-bit executable and all the 64-bit dlls with the 64-bit executable. The rcbasic package tool will automatically do all of this for you as well as package for other systems as well.
</p>
<p>
<h1><b><u>RUN PROGRAMS FROM GEANY</u></b></h1>
</p>
<p>
<b><u>LINUX</u></b> In the installer directory there is a folder called geany_files. Inside the folder there is a file named filetypes.rcbasic. You can override the geany *.bas configuration by replacing the freeBasic configuration with this file. Just copy this file to the geany filedefs path, which on most linux distibutions should be (/home/.config/geany/filedefs), and rename the file to filetypes.freebasic.
</p>
<p>
Once you have rcbasic set up with geany you just need to create a new file and save it as *.bas. Then you can compile your program by going to Build->Compile. Once your program is compiled you can run it by going to Build->Execute.
</p>
<p>
NOTE: If you want to use a different file extension for rcbasic programs you can still use this file and just set it up for a different extension. Refer to the geany documentation on how to set up different file types.
</p>
<p>
<b><u>WINDOWS</u></b> Geany comes preconfigured with rcbasic on windows. Just run the start_editor.bat file and create a new *.bas file. Select the File->New with Template option in the menu to start with a simple template program. Once you have created a new *.bas file goto Build->Compile to compile your program to a *.cbc file. Then goto Build->Execute to run your program.
</p>
<p>
<h1><b><u>USING RCBASIC FROM THE COMMAND-LINE</u></b></h1> RCBasic will be added to path on install on linux. On Windows you will need to add the rcbasic folder to your path. Either (rcbasic/rcbasic_32) or (rcbasic/rcbasic_64) depending on your operating system. Once rcbasic is in your path you can simple pass a source file to rcbasic_build to create a *.cbc file.
</p>
<p id="rc_code"><code>
rcbasic_build&nbsp;myprogram.bas&nbsp;<br>
</code></p>
<p>
Once you have a *.cbc file you can pass it to rcbasic to run it.
</p>
<p id="rc_code"><code>
rcbasic&nbsp;myprogram.cbc&nbsp;<br>
</code></p>
<p>
Both tools also except the --version argument which will simply output the version of rcbasic you are using.
</p>
<p id="rc_code"><code>
rcbasic_build&nbsp;--version&nbsp;<br>
rcbasic&nbsp;-version&nbsp;<br>
</code></p>
<p>
<h1><b><u>PORTING TO OTHER PLATFORMS</u></b></h1>
</p>
<p>
From RCBasic Studio, select tools->distribute and then select the platforms you want to distribute to and click the "MAKE APP" button.
</p>
<p>
</body>
</html>