Upgrading to API v1.1 series

Follow the compatibility notes when upgrading your mods to API v1.1 series

When upgrading your modification from the target of the later version of Nitrocid KS that declares itself to be from the API v1.1, you must make necessary changes to be able to use your mod in a Nitrocid KS version which you use to test your mod. These changes will be listed starting from 0.0.8 to the last version in this API revision.

From 0.0.7 to 0.0.8

This version brought many awesome changes, including the addition of screensavers and SSH.

v0.0.8.x series

CheckSSEs()

CPUFeatures.vb

Public Sub CheckSSEs()

This function was used to get information about your processor's support of the Streaming SIMD Extension (SSE) versions. Since all of today's computers come loaded with SSE2 support, we felt that it was an unnecessary addition, so we removed it. However, it came back in Inxi.NET.

You can use Inxi.NET's CPU Flags property to get advantage of this feature.

Directory Structure Initialization

Filesystem.vb

Public Sub InitStructure()
Private Sub UACNoticeShow()

According to the debug logs inside the function, it was meant to make a list of all the files and directories in the current directory. However, it runs each startup, causing the boot times of the kernel to increase. Also, the populated filesystem list didn't get used across the entire filesystem routine. This caused us to remove the entire functionality.

We advice you to cease using this function, since it's classed as abusive.

From 0.0.8 to 0.0.10

This release brings a vast amount of improvements, but there is one API removal which is pinpointed below.

v0.0.10.x series

DisconnectDbgDevCmd()

RemoteDebugger.vb

Sub DisconnectDbgDevCmd(ByVal IPAddr As String)

This function was released to make a wrapper for the DisconnectDbgDev() function. However, as it was reserved for running in commands according to GetCommand.vb, it was removed for being a duplicate.

Alternatively, you can use the same function in the latest kernel version. DisconnectDbgDev() in API 3.0 can handle these cases. The method signature is shown in the below code block.

RemoteDebugTools.cs

public static void DisconnectDbgDev(string IPAddr)

From 0.0.10 to 0.0.11

This kernel version series added new features, like the text editor.

v0.0.11.x series

InitFS()

Filesystem.vb

Public Sub InitFS()

This function used to call the filesystem structure population which was removed earlier for abuse back in 0.0.4.5. We mean by abuse in this context the hard drive abuse in which the kernel attempts to list all directories and files under the current directory each time the kernel starts. It was removed later for being nothing more than a shortcut for setting the current directory to the home directory.

We advice you to cease using this function.

FTPNotEnoughArgumentsException class

EventsAndExceptions.vb

Public Class FTPNotEnoughArgumentsException

This exception used to be thrown when the user didn't provide enough arguments for any FTP command that needed it. Since it went unused, it was removed multiple times; once in this version, and the last time as part of the kernel exception improvement action.

Since this exception got removed twice, we advice you to cease using this class.

JsonNullException class

EventsAndExceptions.vb

Public Class JsonNullException

This function was thrown each time the currency converter, which was removed in the 0.0.6.x series, reported an invalid JSON string. It was removed as a result of it being unused.

We advice you to cease using this class.

TruncatedManpageException class

EventsAndExceptions.vb

Public Class TruncatedManpageException

This exception used to be thrown when the manual page handler detected that the manual page was truncated or had an invalid format. It was now removed because it went unused, too.

InvalidManpage returned after the manual page parser and viewer returned.

Speak()

VoiceManagement.vb

Public Sub Speak(ByVal Text As String)

Speech function was added in the first version of KS API v1.1, 0.0.8, to aid in trying to make a speech synthesizer for the kernel. We kept running into instabilities because we tried to maintain the cross-platform method of converting text to voice using the Google Translation API after we failed to get the built-in Windows-only voice handler, which was shipped with .NET Framework, to work in Linux.

It was also tried with NAudio in earlier milestones of the version to no avail because that library wasn't designed to work with Linux. The reason behind that is that it uses wrappers for available sound libraries which only exist in Windows, like WaveOut, DirectX's DirectSound, and so on.

Therefore, we decided to remove the entire synthesizer from the kernel as the simulator was no longer biased to Windows systems.

Unless there is a specialized sound library that is cross-platform, we advice you to cease using this function.