Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs/Help/Maps/table_of_contents.xml
Original file line number Diff line number Diff line change
Expand Up @@ -283,6 +283,15 @@
</topicref>
<topicref type="topic" id="423888143662582" build="ALL" modified="2016-05-04T10:32:31.762Z" icon="0" href="VersionHistory">
<caption translate="true">Version History</caption>
<topicref type="topic" id="460575145617501" build="ALL" modified="2026-02-04T08:51:28.814Z" icon="0" href="Known-Issues-in-XSharp-3">
<caption translate="true">Known Issues in XSharp 3</caption>
</topicref>
<topicref type="topic" id="460571586406113" build="ALL" modified="2026-02-04T12:08:33.894Z" icon="0" href="VersionHistoryXSharp2">
<caption translate="true">History XSharp 2</caption>
</topicref>
<topicref type="topic" id="460572396034078" build="ALL" modified="2026-02-04T12:08:37.297Z" icon="0" href="VersionHistoryXSharp1">
<caption translate="true">History XSharp 1 and older</caption>
</topicref>
</topicref>
<topicref type="topic" id="428984094992566" build="ALL" modified="2017-06-12T12:42:21.816Z" icon="0" href="MigratingappsfromVOtoX">
<caption translate="true">Migrating apps from VO to X#</caption>
Expand All @@ -304,6 +313,9 @@
</topicref>
<topicref type="topic" id="432585631903751" build="ALL" modified="2018-06-07T11:14:11.511Z" icon="0" href="The-X-Runtime">
<caption translate="true">The X# Runtime</caption>
<topicref type="topic" id="460576784294169" build="ALL" modified="2026-02-04T12:09:50.608Z" icon="0" href="Nuget-Packages">
<caption translate="true">Nuget Packages</caption>
</topicref>
<topicref type="topic" id="432589511557658" build="ALL" modified="2018-06-07T17:53:51.735Z" icon="0" href="XSharp_Core">
<caption translate="true">XSharp.Core</caption>
</topicref>
Expand Down Expand Up @@ -1469,6 +1481,9 @@
<topicref type="topic" id="449647588802199" build="ALL" modified="2023-02-07T17:45:18.016Z" icon="0" href="command_VAR">
<caption translate="true">VAR Statement</caption>
</topicref>
<topicref type="topic" id="460032363897568" build="ALL" modified="2025-12-12T10:58:48.878Z" icon="0" href="TUPLE">
<caption translate="true">TUPLE type and expression</caption>
</topicref>
</topicref>
</topicref>
<topicref type="topic" id="423890338204503" build="ALL" modified="2019-10-15T13:46:32.053Z" icon="0" href="Expressions">
Expand Down
43 changes: 3 additions & 40 deletions docs/Help/Topics/Bring-Your-Own-Runtime-BYOR.xml
Original file line number Diff line number Diff line change
@@ -1,49 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="../helpproject.xsl" ?>
<topic template="Default" modified="2024-10-08T20:37:12.330+02:00" lasteditedby="Eva" version="2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../helpproject.xsd">
<topic template="Default" modified="2026-02-05T11:58:15.592Z" lasteditedby="robert" version="2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../helpproject.xsd">
<title>Bring Your Own Runtime (BYOR)</title>
<body>
<header>
<para styleclass="Heading1">Bring Your Own Runtime (BYOR)</para>
</header>
<para styleclass="Normal" style="border-color:#000000; border-style:single; border-width:1px; padding:5px;"><table styleclass="Default" rowcount="1" colcount="1" style="background-color:#ffff99; head-row-background-color:#ffff99; alt-row-background-color:#ffff99;">
<thead style="vertical-align:top">
<td>
<para styleclass="Normal" style="border-color:#000000; border-style:single; border-width:1px; padding:5px;"><text style="font-weight:bold;">The X# Runtime is now available. There is no need anymore to compile against the Vulcan Runtime!</text><br/><text style="font-weight:bold;">For now we still support the Vulcan runtime, but that support may be dropped in a future build of X#.</text></para>
</td>
</thead>
</table></para>
<para styleclass="Body Text"></para>
<para styleclass="Body Text">VO and Vulcan support is available in this build of XSharp through what we call the Bring Your Own Runtime principle.</para>
<para styleclass="Normal"></para>
<para styleclass="Normal">If you own a license of Vulcan, you can copy the DLLs that you find in the &lt;Vulcan.NET BaseFolder&gt;\Redist\4.0 folder to a folder that is inside your solution.</para>
<para styleclass="Normal">Then add references to the DLLs that you need in your project.</para>
<para styleclass="Heading3">DLLs you <text style="color:#ff0000;">MUST</text> add if you compile for the VO/Vulcan dialect with the Vulcan runtime:</para>
<para styleclass="Normal"></para>
<list id="0" type="ul" listtype="bullet" formatstring="&#183;" format-charset="SYMBOL_CHARSET" levelreset="true" legalstyle="false" startfrom="1" styleclass="Normal" style="font-family:Symbol; font-size:11pt; color:#000000;">
<li styleclass="Normal">VulcanRT.DLL</li>
<li styleclass="Normal">VulcanRTFuncs.DLL</li>
</list>
<para styleclass="Normal"></para>
<para styleclass="Normal">These 2 files are NEVER added to your Vulcan projects, Vulcan adds a reference to these DLLs automatically. XSharp does not do that, so you should add them yourself. </para>
<para styleclass="Heading3">DLLs that you <text style="color:#ff0000;">MAY</text> want to add, depending on what you are using in your application:</para>
<para styleclass="Normal"></para>
<list id="1" type="ul" listtype="bullet" formatstring="&#183;" format-charset="SYMBOL_CHARSET" levelreset="true" legalstyle="false" startfrom="1" styleclass="Normal" style="font-family:Symbol; font-size:11pt; color:#000000;">
<li styleclass="Normal">VulcanVOSystemClasses.dll </li>
<li styleclass="Normal">VulcanVORDDClasses.dll </li>
<li styleclass="Normal">VulcanVOGUIClasses.dll </li>
<li styleclass="Normal">VulcanVOInternetClasses.dll </li>
<li styleclass="Normal">VulcanVOSQLClasses.dll </li>
<li styleclass="Normal">VulcanVOConsoleClasses.dll </li>
<li styleclass="Normal">VulcanVOWin32APILibrary.dll </li>
</list>
<para styleclass="Normal"></para>
<para styleclass="Heading3">DLLs that you normally do <text style="color:#ff0000;">NOT</text> add to your project (these are handled automatically by the Vulcan Runtime)</para>
<list id="1" type="ul" listtype="bullet" formatstring="&#183;" format-charset="SYMBOL_CHARSET" levelreset="true" legalstyle="false" startfrom="1" styleclass="Normal" style="font-family:Symbol; font-size:11pt; color:#000000;">
<li styleclass="Normal">VulcanRDD.DLL</li>
<li styleclass="Normal">VulcanMacroCompiler.DLL</li>
<li styleclass="Normal">VulcanDBFCDX.dll </li>
<li styleclass="Normal">VulcanDBFFPT.dll </li>
</list>
<para styleclass="Normal" style="border:none;">XSharp 3 no longer suppport &quot;Bring Your Own Runtime&quot;. To compile in a dialect other than Core you need to include a reference to the X# Runtime.</para>
<para styleclass="Normal" style="border:none;">You can still include references to the Vulcan Runtime DLLs in your project but the types and functions in these assemblies are treated like any other .Net assembly.</para>
</body>
</topic>
5 changes: 2 additions & 3 deletions docs/Help/Topics/Combining-X-Runtime-and-Vulcan.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="../helpproject.xsl" ?>
<topic template="Default" modified="2024-10-08T20:10:13.350+02:00" lasteditedby="Eva" version="2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../helpproject.xsd">
<topic template="Default" modified="2026-02-04T09:10:50.951Z" lasteditedby="robert" version="2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../helpproject.xsd">
<title>Combining X# Runtime and Vulcan Runtime</title>
<body>
<header>
<para styleclass="Heading1">Combining X# Runtime and Vulcan Runtime</para>
</header>
<para styleclass="Normal">Technically, it is possible to include both the X# and the Vulcan runtime libraries in your application. When you do so, the compiler will assume that you want to use the X# implementations for the XBase types such as USUAL and DATE. If the compiler does not find the XSharp.Core and XSharp.VO assemblies, it will assume that you want to map these types to the Vulcan runtime types.</para>
<para styleclass="Normal">Even though you can mix things, if you want to call code in the Vulcan runtime DLLs, you may have to use the fully qualified classnames or typenames.</para>
<para styleclass="Normal">Technically, it is possible to include both the X# and the Vulcan runtime libraries in your application. When you do so, the compiler will assume that you want to use the X# implementations for the XBase types such as USUAL and DATE. If the compiler does not find the XSharp.Core and XSharp.VO assemblies then it will only work in the Core dialect.</para>
<para styleclass="Normal">And remember: there is no automatic translation between the X# types and Vulcan types. </para>
<para styleclass="Normal">If you want to convert an X# variable to a Vulcan variable, you may have to cast it to an intermediate type first.</para>
<para styleclass="Normal"></para>
Expand Down
Loading
Loading