I hear Kiln 2.0 introduced a brand new search feature! What does it do, and how do I use it?
Indeed, there is a new search feature that's available in Kiln 2.0, and it's designed so that you can quickly find what you're looking for in Kiln and navigate around your code with ease.
There are three basic types of search results available in Kiln 2.0: Changesets, Filenames, and Code results.
Kiln 2.0 gives you the ability to search through commit messages in a repository to find the exact changeset you're looking for. For instance, if you're looking for that changeset where you made changes to the
But changeset search goes even further. If we want to narrow these results by changeset author, say myself, I can filter by username by adding
Ta-da! I've restricted my results from the first search in order to find only the changes that I've made.
But over time, there could be hundreds of changesets authored by me, and many of them could contain similar words. Thankfully, we can tell Kiln to only look for changesets within a certain date range. For instance, if I want to find all the builds our awesome build manager has tagged in the last two weeks, all I need to do is search
To find all changesets that are contained between two tags, search for the two tags separated by two colons, e.g.
Often, you'll want to go into Kiln and look at a file's history or you'll want to view the contents of a file you don't have cloned to your computer. File search is meant to get you to the file you're looking for without having to navigate the repository file tree. If I want to double-check how a specific function works in our
One of the most powerful features of Kiln Search is the ability to search for items inside your code. If you're looking for the definition of a specific function or variable, searching using the query
Likewise, a search for
How does Kiln determine which repository to search in initially?
Kiln tries to guess which repository is most likely to have the result you're looking for based on a few factors. First, if you're already on a repository screen or have used the repository selector widgit on the search page, then Kiln will look in that repository first first. If not, Kiln looks at your most commonly used repositories and find the first repository with a result.
Failing both of these, Kiln will show you the repository with the most results.
I keep forgetting all these search axis. Is there any other way for me to use them?
Remembering the name of each search axis can be difficult, especially if you don't use Kiln search often. Although using the name of the axis in the query will be the fastest way to use an axis, the Search Options popup on the results page gives you a friendly interface to the same features.