Skip to content

Commit

Permalink
Removed more references to third party docs
Browse files Browse the repository at this point in the history
  • Loading branch information
wouterj authored and fabpot committed Aug 11, 2014
1 parent 1d468dd commit 3846bd9
Show file tree
Hide file tree
Showing 7 changed files with 43 additions and 45 deletions.
6 changes: 0 additions & 6 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,8 +1,2 @@
/_build
/bundles/DoctrineFixturesBundle
/bundles/DoctrineMigrationsBundle
/bundles/DoctrineMongoDBBundle
/bundles/SensioFrameworkExtraBundle
/bundles/SensioGeneratorBundle
/cmf
/_exts
6 changes: 3 additions & 3 deletions book/controller.rst
Original file line number Diff line number Diff line change
Expand Up @@ -552,9 +552,7 @@ The Symfony templating engine is explained in great detail in the
.. tip::

You can even avoid calling the ``render`` method by using the ``@Template``
annotation. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/view>`
more details.
annotation. See the `FrameworkExtraBundle documentation`_ more details.

.. tip::

Expand Down Expand Up @@ -826,3 +824,5 @@ Learn more from the Cookbook

* :doc:`/cookbook/controller/error_pages`
* :doc:`/cookbook/controller/service`

.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
25 changes: 14 additions & 11 deletions book/doctrine.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ be.
easy, and explained in the ":doc:`/cookbook/doctrine/dbal`" cookbook entry.

You can also persist data to `MongoDB`_ using Doctrine ODM library. For
more information, read the ":doc:`/bundles/DoctrineMongoDBBundle/index`"
more information, read the "`DoctrineMongoDBBundle`_"
documentation.

A Simple Example: A Product
Expand Down Expand Up @@ -473,10 +473,10 @@ in your application. To do this, run:
new column to the existing ``product`` table.

An even better way to take advantage of this functionality is via
:doc:`migrations </bundles/DoctrineMigrationsBundle/index>`, which allow you to
generate these SQL statements and store them in migration classes that
can be run systematically on your production server in order to track
and migrate your database schema safely and reliably.
`migrations`_, which allow you to generate these SQL statements and store
them in migration classes that can be run systematically on your production
server in order to track and migrate your database schema safely and
reliably.

Your database now has a fully-functional ``product`` table with columns that
match the metadata you've specified.
Expand Down Expand Up @@ -562,7 +562,7 @@ an ``UPDATE`` query if the record already exists in the database.

Doctrine provides a library that allows you to programmatically load testing
data into your project (i.e. "fixture data"). For information, see
:doc:`/bundles/DoctrineFixturesBundle/index`.
the "`DoctrineFixturesBundle`_" documentation.

Fetching Objects from the Database
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -589,8 +589,7 @@ on its ``id`` value::
.. tip::

You can achieve the equivalent of this without writing any code by using
the ``@ParamConverter`` shortcut. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/converters>`
the ``@ParamConverter`` shortcut. See the `FrameworkExtraBundle documentation`_
for more details.

When you query for a particular type of object, you always use what's known
Expand Down Expand Up @@ -1084,7 +1083,7 @@ table, and ``product.category_id`` column, and new foreign key:

This task should only be really used during development. For a more robust
method of systematically updating your production database, read about
:doc:`Doctrine migrations </bundles/DoctrineMigrationsBundle/index>`.
`migrations`_.

Saving Related Entities
~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -1400,8 +1399,8 @@ For more information about Doctrine, see the *Doctrine* section of the

* :doc:`/cookbook/doctrine/common_extensions`
* :doc:`/cookbook/doctrine/console`
* :doc:`/bundles/DoctrineFixturesBundle/index`
* :doc:`/bundles/DoctrineMongoDBBundle/index`
* :doc:`DoctrineFixturesBundle`
* :doc:`DoctrineMongoDBBundle`

.. _`Doctrine`: http://www.doctrine-project.org/
.. _`MongoDB`: http://www.mongodb.org/
Expand All @@ -1414,3 +1413,7 @@ For more information about Doctrine, see the *Doctrine* section of the
.. _`Lifecycle Events documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#lifecycle-events
.. _`Reserved SQL keywords documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
.. _`Persistent classes`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#persistent-classes
.. _`DoctrineMongoDBBundle`: http://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
.. _`migrations`: http://symfony.com/doc/current/bundles/DoctrineMigrationsBundle/index.html
.. _`DoctrineFixturesBundle`: http://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
4 changes: 2 additions & 2 deletions book/routing.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1070,8 +1070,7 @@ from the new routing resource.
.. tip::

You can also define routes using annotations. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/routing>`
to see how.
`FrameworkExtraBundle documentation`_ to see how.

Adding a Host Requirement to Imported Routes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -1298,3 +1297,4 @@ Learn more from the Cookbook
* :doc:`/cookbook/routing/scheme`

.. _`FOSJsRoutingBundle`: https://github.com/FriendsOfSymfony/FOSJsRoutingBundle
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/routing.html
34 changes: 17 additions & 17 deletions components/http_kernel/introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -288,16 +288,15 @@ on the event object that's passed to listeners on this event.
the Symfony Framework, and many deal with collecting profiler data when
the profiler is enabled.

One interesting listener comes from the :doc:`SensioFrameworkExtraBundle </bundles/SensioFrameworkExtraBundle/index>`,
One interesting listener comes from the `SensioFrameworkExtraBundle`_,
which is packaged with the Symfony Standard Edition. This listener's
:doc:`@ParamConverter </bundles/SensioFrameworkExtraBundle/annotations/converters>`
functionality allows you to pass a full object (e.g. a ``Post`` object)
to your controller instead of a scalar value (e.g. an ``id`` parameter
that was on your route). The listener - ``ParamConverterListener`` - uses
reflection to look at each of the arguments of the controller and tries
to use different methods to convert those to objects, which are then
stored in the ``attributes`` property of the ``Request`` object. Read the
next section to see why this is important.
`@ParamConverter`_ functionality allows you to pass a full object (e.g. a
``Post`` object) to your controller instead of a scalar value (e.g. an
``id`` parameter that was on your route). The listener -
``ParamConverterListener`` - uses reflection to look at each of the
arguments of the controller and tries to use different methods to convert
those to objects, which are then stored in the ``attributes`` property of
the ``Request`` object. Read the next section to see why this is important.

4) Getting the Controller Arguments
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -395,14 +394,12 @@ return a ``Response``.
.. sidebar:: ``kernel.view`` in the Symfony Framework

There is no default listener inside the Symfony Framework for the ``kernel.view``
event. However, one core bundle -
:doc:`SensioFrameworkExtraBundle </bundles/SensioFrameworkExtraBundle/index>` -
*does* add a listener to this event. If your controller returns an array,
and you place the :doc:`@Template </bundles/SensioFrameworkExtraBundle/annotations/view>`
annotation above the controller, then this listener renders a template,
passes the array you returned from your controller to that template,
and creates a ``Response`` containing the returned content from that
template.
event. However, one core bundle - `SensioFrameworkExtraBundle`_ - *does*
add a listener to this event. If your controller returns an array,
and you place the `@Template`_ annotation above the controller, then this
listener renders a template, passes the array you returned from your
controller to that template, and creates a ``Response`` containing the
returned content from that template.

Additionally, a popular community bundle `FOSRestBundle`_ implements
a listener on this event which aims to give you a robust view layer
Expand Down Expand Up @@ -689,3 +686,6 @@ look like this::
.. _reflection: http://php.net/manual/en/book.reflection.php
.. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
.. _`Create your own framework... on top of the Symfony2 Components`: http://fabien.potencier.org/article/50/create-your-own-framework-on-top-of-the-symfony2-components-part-1
.. _`SensioFrameworkExtraBundle`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
.. _`@ParamConverter`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
6 changes: 3 additions & 3 deletions cookbook/controller/service.rst
Original file line number Diff line number Diff line change
Expand Up @@ -132,9 +132,8 @@ the route ``_controller`` value:
.. tip::

You can also use annotations to configure routing using a controller
defined as a service. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/routing>`
for details.
defined as a service. See the `FrameworkExtraBundle documentation`_ for
details.

Alternatives to base Controller Methods
---------------------------------------
Expand Down Expand Up @@ -267,3 +266,4 @@ inject *only* the exact service(s) that you need directly into the controller.

.. _`Controller class source code`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
.. _`base Controller class`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/routing.html
7 changes: 4 additions & 3 deletions cookbook/templating/PHP.rst
Original file line number Diff line number Diff line change
Expand Up @@ -60,11 +60,10 @@ below renders the ``index.html.php`` template::
);
}

You can also use the :doc:`/bundles/SensioFrameworkExtraBundle/annotations/view`
shortcut to render the default ``AcmeHelloBundle:Hello:index.html.php`` template::
You can also use the `@Template`_ shortcut to render the default
``AcmeHelloBundle:Hello:index.html.php`` template::

// src/Acme/HelloBundle/Controller/HelloController.php

use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;

// ...
Expand Down Expand Up @@ -326,3 +325,5 @@ within an HTML context. The second argument lets you change the context. For
instance, to output something in a JavaScript script, use the ``js`` context::

<?php echo $view->escape($var, 'js') ?>

.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view`

0 comments on commit 3846bd9

Please sign in to comment.