diff options
Diffstat (limited to 'indra/newview/llviewerhelp.cpp')
| -rw-r--r-- | indra/newview/llviewerhelp.cpp | 136 | 
1 files changed, 68 insertions, 68 deletions
diff --git a/indra/newview/llviewerhelp.cpp b/indra/newview/llviewerhelp.cpp index 3181ae6283..e7b150965d 100644 --- a/indra/newview/llviewerhelp.cpp +++ b/indra/newview/llviewerhelp.cpp @@ -1,4 +1,4 @@ -/**  +/**   * @file llviewerhelp.cpp   * @brief Utility functions for the Help system   * @author Tofu Linden @@ -6,21 +6,21 @@   * $LicenseInfo:firstyear=2009&license=viewerlgpl$   * Second Life Viewer Source Code   * Copyright (C) 2010, Linden Research, Inc. - *  + *   * This library is free software; you can redistribute it and/or   * modify it under the terms of the GNU Lesser General Public   * License as published by the Free Software Foundation;   * version 2.1 of the License only. - *  + *   * This library is distributed in the hope that it will be useful,   * but WITHOUT ANY WARRANTY; without even the implied warranty of   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU   * Lesser General Public License for more details. - *  + *   * You should have received a copy of the GNU Lesser General Public   * License along with this library; if not, write to the Free Software   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA - *  + *   * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA   * $/LicenseInfo$   */ @@ -42,27 +42,27 @@  class LLHelpHandler : public LLCommandHandler  {  public: -	// requests will be throttled from a non-trusted browser -	LLHelpHandler() : LLCommandHandler("help", UNTRUSTED_CLICK_ONLY) {} - -	bool handle(const LLSD& params, const LLSD& query_map, const std::string& grid, LLMediaCtrl* web) -	{ -		LLViewerHelp* vhelp = LLViewerHelp::getInstance(); -		if (! vhelp) -		{ -			return false; -		} - -		// get the requested help topic name, or use the fallback if none -		std::string help_topic = vhelp->defaultTopic(); -		if (params.size() >= 1) -		{ -			help_topic = params[0].asString(); -		} - -		vhelp->showTopic(help_topic); -		return true; -	} +    // requests will be throttled from a non-trusted browser +    LLHelpHandler() : LLCommandHandler("help", UNTRUSTED_CLICK_ONLY) {} + +    bool handle(const LLSD& params, const LLSD& query_map, const std::string& grid, LLMediaCtrl* web) +    { +        LLViewerHelp* vhelp = LLViewerHelp::getInstance(); +        if (! vhelp) +        { +            return false; +        } + +        // get the requested help topic name, or use the fallback if none +        std::string help_topic = vhelp->defaultTopic(); +        if (params.size() >= 1) +        { +            help_topic = params[0].asString(); +        } + +        vhelp->showTopic(help_topic); +        return true; +    }  };  LLHelpHandler gHelpHandler; @@ -71,49 +71,49 @@ LLHelpHandler gHelpHandler;  std::string LLViewerHelp::getURL(const std::string &topic)  { -	// if the help topic is empty, use the default topic -	std::string help_topic = topic; -	if (help_topic.empty()) -	{ -		help_topic = defaultTopic(); -	} - -	// f1 help topic means: if the user is not logged in yet, show -	// the pre-login topic instead of the default fallback topic, -	// otherwise show help for the focused item -	if (help_topic == f1HelpTopic()) -	{ -		help_topic = getTopicFromFocus(); -		if (help_topic == defaultTopic() && ! LLLoginInstance::getInstance()->authSuccess()) -		{ -			help_topic = preLoginTopic(); -		} -	} - -	return LLViewerHelpUtil::buildHelpURL( help_topic ); +    // if the help topic is empty, use the default topic +    std::string help_topic = topic; +    if (help_topic.empty()) +    { +        help_topic = defaultTopic(); +    } + +    // f1 help topic means: if the user is not logged in yet, show +    // the pre-login topic instead of the default fallback topic, +    // otherwise show help for the focused item +    if (help_topic == f1HelpTopic()) +    { +        help_topic = getTopicFromFocus(); +        if (help_topic == defaultTopic() && ! LLLoginInstance::getInstance()->authSuccess()) +        { +            help_topic = preLoginTopic(); +        } +    } + +    return LLViewerHelpUtil::buildHelpURL( help_topic );  }  void LLViewerHelp::showTopic(const std::string& topic)  { -	LLFloaterReg::showInstance("help_browser", topic); +    LLFloaterReg::showInstance("help_browser", topic);  }  std::string LLViewerHelp::defaultTopic()  { -	// *hack: to be done properly -	return "this_is_fallbacktopic"; +    // *hack: to be done properly +    return "this_is_fallbacktopic";  }  std::string LLViewerHelp::preLoginTopic()  { -	// *hack: to be done properly -	return "pre_login_help"; +    // *hack: to be done properly +    return "pre_login_help";  }  std::string LLViewerHelp::f1HelpTopic()  { -	// *hack: to be done properly -	return "f1_help"; +    // *hack: to be done properly +    return "f1_help";  }  ////////////////////////////// @@ -121,20 +121,20 @@ std::string LLViewerHelp::f1HelpTopic()  std::string LLViewerHelp::getTopicFromFocus()  { -	// use UI element with viewer's keyboard focus as basis for searching -	LLUICtrl* focused = dynamic_cast<LLUICtrl*>(gFocusMgr.getKeyboardFocus()); - -	if (focused) -	{ -		std::string topic; -		if (focused->findHelpTopic(topic)) -		{ -			return topic; -		} -	} - -	// didn't find a help topic in the UI hierarchy for focused -	// element, return the fallback topic name instead. -	return defaultTopic(); +    // use UI element with viewer's keyboard focus as basis for searching +    LLUICtrl* focused = dynamic_cast<LLUICtrl*>(gFocusMgr.getKeyboardFocus()); + +    if (focused) +    { +        std::string topic; +        if (focused->findHelpTopic(topic)) +        { +            return topic; +        } +    } + +    // didn't find a help topic in the UI hierarchy for focused +    // element, return the fallback topic name instead. +    return defaultTopic();  }  | 
