ZDoom Wiki Thread

We sure do have a lot of rules and guidelines threads - find them all here, and please make sure you've read them! Also, community-wide announcements (that aren't major ZDoom News) go here as well.
Gez
 
 
Posts: 17939
Joined: Fri Jul 06, 2007 3:22 pm

Re: ZDoom Wiki Thread

Post by Gez »

Blzut3 wrote:First the deprecation warning on [wiki]SetLineBlocking[/wiki] may be a little misleading. This is a Hexen feature, and as such compatibility is a must and not just "may be retained". Perhaps a notice suggestion the use of Line_SetBlocking would be better?
That's the [wiki]Template:WarnDeprecated[/wiki] boilerplate. It is excessively alarming IMO too.
Blzut3 wrote:Also it might be worth mentioning the purpose of FunctionName(const:parameters). This serves a purpose in optimizing scripts since a const function doesn't use push instructions for each of it's arguments.
Does it actually have a noticeable impact?
User avatar
Zippy
Posts: 3302
Joined: Wed Mar 23, 2005 5:31 pm
Location: New Jersey

Re: ZDoom Wiki Thread

Post by Zippy »

Gez wrote:
Blzut3 wrote:First the deprecation warning on [wiki]SetLineBlocking[/wiki] may be a little misleading. This is a Hexen feature, and as such compatibility is a must and not just "may be retained". Perhaps a notice suggestion the use of Line_SetBlocking would be better?
That's the [wiki]Template:WarnDeprecated[/wiki] boilerplate. It is excessively alarming IMO too.
While it is a little aggressive, it does serve its primary point: any new maps created after the point of deprecation should never use the feature; instead using the replacement feature. While it can technically, and in a lot of ways completely safely, be gotten away with, its still a point of both principle and caution. So anyone who feels they know better may certainly disregard it (at their own peril if the case actually merits it), but for the people who don't know any better or actively refuse learn better, if the extra aggressiveness just convinces them even more that they should be using the correct new feature out of some imagined risk then really what harm is there in it?

Gez wrote:
Blzut3 wrote:Also it might be worth mentioning the purpose of FunctionName(const:parameters). This serves a purpose in optimizing scripts since a const function doesn't use push instructions for each of it's arguments.
Does it actually have a noticeable impact?
I don't recall specifically but I seem to remember Randy or Graf at one point saying that scripting was efficient enough to the point that the effect of using the const was incredibly negligible.
Blzut3
 
 
Posts: 3203
Joined: Wed Nov 24, 2004 12:59 pm
Graphics Processor: ATI/AMD with Vulkan/Metal Support
Contact:

Re: ZDoom Wiki Thread

Post by Blzut3 »

Gez wrote:Does it actually have a noticeable impact?
It may not have an impact performance wise, but it might be a nice tip for those who may be having problems with runaway scripts. I know there was a thread about a non-infinite loop runaway at least once.

Edit: At the very least it may be worth documenting these things so that if someone finds old code using it they understand what it means. Even if we don't document it on the page for each function where it applies.
Zippy wrote:While it is a little aggressive, it does serve its primary point: any new maps created after the point of deprecation should never use the feature; instead using the replacement feature. While it can technically, and in a lot of ways completely safely, be gotten away with, its still a point of both principle and caution. So anyone who feels they know better may certainly disregard it (at their own peril if the case actually merits it), but for the people who don't know any better or actively refuse learn better, if the extra aggressiveness just convinces them even more that they should be using the correct new feature out of some imagined risk then really what harm is there in it?
My point is the ZDoom wiki is often used as a general reference for things even outside of ZDoom. While there may be a better alternative in ZDoom, someone writing a Hexen compatible script may not want to use the alternative. Thus the deprecation warning is kind of out of place in this one specific instance.
Last edited by Blzut3 on Tue Jun 29, 2010 5:30 pm, edited 1 time in total.
User avatar
Zippy
Posts: 3302
Joined: Wed Mar 23, 2005 5:31 pm
Location: New Jersey

Re: ZDoom Wiki Thread

Post by Zippy »

Blzut3 wrote:
Gez wrote:Does it actually have a noticeable impact?
It may not have an impact performance wise, but it might be a nice tip for those who may be having problems with runaway scripts. I know there was a thread about a non-infinite loop runaway at least once.
Sure. Using the [wiki=distance]wiki's defined distance function[/wiki] is an easy way to induce that. If you have a few objects to check at sufficient distances you'll hit the instruction limit easy. In that specific case there are easily workable alternatives (specifically distance approximations that are accurate while the two points are close enough, etc.).

Hm. I think I'd still personally take a runaway script as a sign that I'm doing something wrong but I suppose it's worth noting somewhere.

Blzut3 wrote:My point is the ZDoom wiki is often used as a general reference for things even outside of ZDoom. While there may be a better alternative in ZDoom, someone writing a Hexen compatible script may not want to use the alternative. Thus the deprecation warning is kind of out of place in this one specific instance.
I'm approaching it from the opposite side. Because the wiki is primarily a source of modding information for ZDoom, preference is given to the strong deprecation warning, but there's no trouble with including a special note SetLineBlocking's article that it is Hexen compatible.
Gez
 
 
Posts: 17939
Joined: Fri Jul 06, 2007 3:22 pm

Re: ZDoom Wiki Thread

Post by Gez »

And here we see the how useful templates can be.
User avatar
FDARI
Posts: 1097
Joined: Tue Nov 03, 2009 9:19 am

Re: ZDoom Wiki Thread

Post by FDARI »

The function PlayerNumber contains a usage example with script number 1000. The beginner's guide still specifies a number range from 1 - 999 and a quick test with the compiler proves that the restriction does still apply. It is a minor issue, but examples should be free of errors, right?

Code: Select all

script 1000 ENTER
{
	Thing_ChangeTID(0, 1000 + PlayerNumber());
}
Also; if I run across equally obvious errors in the wiki, should I post here and/or correct the page, or forever hold my silence?
Gez
 
 
Posts: 17939
Joined: Fri Jul 06, 2007 3:22 pm

Re: ZDoom Wiki Thread

Post by Gez »

Well, as far as script numbers go, they're fairly arbitrary (you're not supposed to necessarily use the same number as in the examples), but why not.
FDARI wrote:Also; if I run across equally obvious errors in the wiki, should I post here and/or correct the page
Yes.
User avatar
cq75
Posts: 1212
Joined: Sun Dec 27, 2009 9:28 pm
Graphics Processor: nVidia with Vulkan support
Location: Just beyond the line horizon

Re: ZDoom Wiki Thread

Post by cq75 »

Should we add something to [wiki]Sector_Set3dFloor[/wiki] about side texture alignment?
Gez
 
 
Posts: 17939
Joined: Fri Jul 06, 2007 3:22 pm

Re: ZDoom Wiki Thread

Post by Gez »

Why do people even ask these questions?
User avatar
cq75
Posts: 1212
Joined: Sun Dec 27, 2009 9:28 pm
Graphics Processor: nVidia with Vulkan support
Location: Just beyond the line horizon

Re: ZDoom Wiki Thread

Post by cq75 »

Gez wrote:Why do people even ask these questions?
I can't speak for the other people who asked a "should we add X to the wiki" question, but I was hoping somebody else who knew more about the subject than I do would add something, because right now I'm not 100% sure of how it works. But if nobody else is interested in writing it, I'll mess with the function in DB until I feel comfortable with it and add something myself.
Gez
 
 
Posts: 17939
Joined: Fri Jul 06, 2007 3:22 pm

Re: ZDoom Wiki Thread

Post by Gez »

I'm getting "Internal error -- Set $wgShowExceptionDetails = true; at the bottom of LocalSettings.php to show detailed debugging information." when attempting to save a change to [wiki]Player properties[/wiki].
Spoiler:
Gez
 
 
Posts: 17939
Joined: Fri Jul 06, 2007 3:22 pm

Re: ZDoom Wiki Thread

Post by Gez »

Gez wrote:I'm getting "Internal error -- Set $wgShowExceptionDetails = true; at the bottom of LocalSettings.php to show detailed debugging information." when attempting to save a change to [wiki]Player properties[/wiki].
Still broken, on all pages I've tried.
User avatar
randi
Site Admin
Posts: 7749
Joined: Wed Jul 09, 2003 10:30 pm
Contact:

Re: ZDoom Wiki Thread

Post by randi »

Should be fixed now.
Gez
 
 
Posts: 17939
Joined: Fri Jul 06, 2007 3:22 pm

Re: ZDoom Wiki Thread

Post by Gez »

It is, thanks. :)
User avatar
randi
Site Admin
Posts: 7749
Joined: Wed Jul 09, 2003 10:30 pm
Contact:

Re: ZDoom Wiki Thread

Post by randi »

The wiki has been updated to MediaWiki 1.16.0. Please let me know if anything was broken during the upgrade.
Post Reply

Return to “Rules and Forum Announcements”