Changes to SkTDStackNester.

SkTDStackNester is a class used by PdfViewer to assist in saving
and restoring the PDF state. Clean up and test this class.

Add some documentation.

Add FIXME's where I have questions to resolve.

Fix a bug where fNestingLevel was not initialized.

Remove a commented out line of code copied over from
SkTDStack.

Rename SkTDStackNester::nests() to nestingLevel() and make it const.

Remove unnecessary predeclaration and friend declaration.

Remove index() (both const and non-const versions). They were
unused, return something that may not be expected (index from
the top, rather than from the bottom), and don't work to get any
elements in earlier Recs once the first one is full.

Report a warning if the nesting level goes above the maximum level,
or if we attempt to bring it below zero.

Prevent fNestingLevel from dropping below zero.

Add kUnusedObject_SkPdfIssue, and use it where appropriate.

Depends on https://codereview.chromium.org/64093009/

R=mtklein@google.com

Review URL: https://codereview.chromium.org/68843006

git-svn-id: http://skia.googlecode.com/svn/trunk/gyp@12328 2bbb7eff-a529-9590-31e7-b0007b416f81
diff --git a/experimental.gyp b/experimental.gyp
index 5552b4c..76bf071 100644
--- a/experimental.gyp
+++ b/experimental.gyp
@@ -1,3 +1,4 @@
+# GYP file to build experimental directory.
 {
   'targets': [
     {
diff --git a/tests.gyp b/tests.gyp
index 2462c81..890a146 100644
--- a/tests.gyp
+++ b/tests.gyp
@@ -17,6 +17,10 @@
         '../src/pipe/utils',
         '../src/utils',
         '../tools/',
+
+        # Needed for TDStackNesterTest.
+        '../experimental/PdfViewer',
+        '../experimental/PdfViewer/src',
       ],
       'includes': [
         'pathops_unittest.gypi',
@@ -152,6 +156,9 @@
         '../tests/Writer32Test.cpp',
         '../tests/XfermodeTest.cpp',
 
+        '../experimental/PdfViewer/src/SkTDStackNester.h',
+        '../tests/TDStackNesterTest.cpp',
+
         # Needed for PipeTest.
         '../src/pipe/utils/SamplePipeControllers.cpp',
       ],