comparison doc/user_guide.txt @ 8172:6a58acc3f39f

docs: new example, summary issue2550698 - Document the logical expression search a bit
author John Rouillard <rouilj@ieee.org>
date Mon, 02 Dec 2024 12:02:36 -0500
parents 188b7a549f20
children 079958914ed7
comparison
equal deleted inserted replaced
8171:188b7a549f20 8172:6a58acc3f39f
474 expression: ``(not user3) and (not user1)``. Using the rules of logic, 474 expression: ``(not user3) and (not user1)``. Using the rules of logic,
475 this is the same as: ``not (user3 or user1)`` which is expressed in 475 this is the same as: ``not (user3 or user1)`` which is expressed in
476 RPN as ``creator=3,1,-4,-2``. Compare this to ``creator=3,1,-2`` which 476 RPN as ``creator=3,1,-4,-2``. Compare this to ``creator=3,1,-2`` which
477 returns issues created by user3 or any user other than user1. 477 returns issues created by user3 or any user other than user1.
478 478
479 Another example, useful when filtering issues, is:
480
481 keyword=-1,-2,1,8,-3,-2,-3
482
483 which returns issues that have one or more keywords set and the issue
484 does not have keyword1 and keyword8 both set. In more standard infix
485 form:
486
487 not empty and not (keyword1 and keyword8)
488
479 Typing these expressions manually can be tiresome, so there's an 489 Typing these expressions manually can be tiresome, so there's an
480 expression editor on the search page. You can access it by clicking on 490 expression editor on the search page. You can access it by clicking on
481 the ``(expr)`` link, which makes creating these expressions a bit 491 the ``(expr)`` link, which makes creating these expressions a bit
482 easier. 492 easier. But at least you can use this info to understand the search
493 syntax in the URL.
483 494
484 Using the Classhelper 495 Using the Classhelper
485 --------------------- 496 ---------------------
486 497
487 The classhelper makes finding the id number or name for linked items 498 The classhelper makes finding the id number or name for linked items

Roundup Issue Tracker: http://roundup-tracker.org/