Custom TESH Highlighting
Table of Contents- Introduction
- Step 1: The Declaration File
- Step 2: Implementation
- Wrap-Up
- FAQ
IntroductionIn this tutorial, I'm going to teach you how to get custom TESH highlighting.
This is common knowledge for a lot of people, but not for everyone.
It's actually quite simple, so I don't think anyone should have trouble with it.
What I mean by custom highlighting is highlighting for certain functions.
This can be useful for very common libraries like TimerUtils or UnitIndexer.
I even used it to provide me with highlighting for the hashtable natives.
Step 1: The Declaration FileThe first thing we have to do is declare the functions that we want to highlight for TESH to highlight them. What we're going to do is open up Notepad.exe or anything other simple Text-Editor to get started.
I'm going to assume that we want highlighting for TimerUtils by Vexorian.
These are the following functions we want highlighting for:
function NewTimer
takes nothing returns timer function ReleaseTimer
takes timer t
returns nothing function SetTimerData
takes timer t,
integer data
returns nothing
As you can see, those functions don't highlight, and it's pretty annoying, especially considering the fact that a lot of us use them all the time.
Now, you're probably asking yourself: "What am I going to have to include in that file?
Come on Magtheridon96, get to the point already!"
Well, all you have to include is function declarations. You don't need to include any code at all, just the function declaration with the name, the arguments and the return-type.
For TimerUtils by Vexorian, it's going to look like this:
// Putting comments here is fine.
// These comments don't show up in the TESH function definitions
// though. You can put content for self-reference inside the function
// definitions in this file though. It's quite handy. Sometimes, you
// might forget what a function does, what form of arguments it
// should take, and a simple type-list isn't going to help. That's
// where these comments become quite useful.
function NewTimer
takes nothing returns timer // Retrieves a new timer from the recycling stack.
endfunction
// Retrieves a new timer from the recycling stack and sets it's data.
endfunction
function ReleaseTimer
takes timer t
returns nothing // Throws a timer into the recycling stack.
endfunction
function SetTimerData
takes timer t,
integer data
returns nothing // Attaches data to a timer.
endfunction
// Gets the data attached to a timer.
endfunction
// The same can be said about for this comment as well.
// This won't get into the function definitions module.
// If you would go down a bit, I explain a bit about this
// function definition module in the "Tip" below.
Some people prefer to add comments within the functions.
When you're done with this tutorial, these function declarations and whatever code is in them will be available and can be referenced while you're in the editor simply by holding Ctrl (or Command for Mac Users), and clicking on the function. The comments can be useful for complex functions. They can act as a reminder to you about how a certain function is supposed to take arguments or what it does.
Now that we're done with our declaration file, we're going to save it in the .j format.
If you're using Notepad, all you have to do is Select "File > Save As", then, where it says "Text Document (.txt)", you would change it to "All Files". Now save the file with the extension .j at the end of the name.
Congratulations, you now have a TESH function declaration file!
Step 2: ImplementationWe aren't done yet, we still haven't implemented our file.
This step is very easy and straightforward.
- Open up the JNGP folder.
- Open the folder named "tesh".
- Open the folder named "includes".
Now move the function declaration file into the "includes" folder.
Congratulations, you're done!
Wrap-UpI hope you liked this tutorial. I'm aware that a lot of this is common knowledge.
Still, I believe that this requires a tutorial. If you're having problems, refer to the below FAQ Section:
FAQQuestions- Why doesn't the highlighting show up at all?
- My file isn't saving as .j! What should I do?
- I tried copying the Hashtable natives from common.j, but when I paste them and save the file, the text wraps in some very obscure way.
- Why doesn't the highlighting show up for custom natives?
- Why can't I add struct methods?
Answers- If you were doing the above steps with JNGP running, it isn't going to work.
All you need to do is restart JNGP and the highlighting should work fine. If you're still having problems, then you either saved the .j file in the wrong directory, or you saved it as a .txt file or something. This only works for .j files. - Well, an obscure solution would be to find to open up the JNGP folder, go to the "jasshelper" subfolder, make a copy of common.j, rename it, and change the text.
- Yeah, some people might face this problem. In the attachments, I've placed a Ready-To-Go Hashtable native declaration file. All you need to do is follow Step 2.
- You can't declare them as natives. Declare them as functions. That won't tamper with anything, the highlighting has no effect on the Jass Parser.
- Because SFilip made it a limitation. You can't add struct methods unfortunately.
Side-Note: I hope you like this tutorial.
Jass Tutorials
