Skip to content

Commit c39ea1d

Browse files
wouterjfabpot
authored andcommitted
Removed more references to third party docs
1 parent 0e2c491 commit c39ea1d

File tree

5 files changed

+38
-40
lines changed

5 files changed

+38
-40
lines changed

.gitignore

-6
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,2 @@
11
/_build
2-
/bundles/DoctrineFixturesBundle
3-
/bundles/DoctrineMigrationsBundle
4-
/bundles/DoctrineMongoDBBundle
5-
/bundles/SensioFrameworkExtraBundle
6-
/bundles/SensioGeneratorBundle
7-
/cmf
82
/_exts

book/doctrine.rst

+14-11
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ can be.
2222
easy, and explained in the ":doc:`/cookbook/doctrine/dbal`" cookbook entry.
2323

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

2828
A Simple Example: A Product
@@ -471,10 +471,10 @@ in your application. To do this, run:
471471
new column to the existing ``product`` table.
472472

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

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

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

564564
Fetching Objects from the Database
565565
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -586,8 +586,7 @@ on its ``id`` value::
586586
.. tip::
587587

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

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

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

10881087
Saving Related Entities
10891088
~~~~~~~~~~~~~~~~~~~~~~~
@@ -1400,8 +1399,8 @@ For more information about Doctrine, see the *Doctrine* section of the
14001399

14011400
* :doc:`/cookbook/doctrine/common_extensions`
14021401
* :doc:`/cookbook/doctrine/console`
1403-
* :doc:`/bundles/DoctrineFixturesBundle/index`
1404-
* :doc:`/bundles/DoctrineMongoDBBundle/index`
1402+
* :doc:`DoctrineFixturesBundle`
1403+
* :doc:`DoctrineMongoDBBundle`
14051404

14061405
.. _`Doctrine`: http://www.doctrine-project.org/
14071406
.. _`MongoDB`: http://www.mongodb.org/
@@ -1414,3 +1413,7 @@ For more information about Doctrine, see the *Doctrine* section of the
14141413
.. _`Lifecycle Events documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#lifecycle-events
14151414
.. _`Reserved SQL keywords documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
14161415
.. _`Persistent classes`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#persistent-classes
1416+
.. _`DoctrineMongoDBBundle`: http://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
1417+
.. _`migrations`: http://symfony.com/doc/current/bundles/DoctrineMigrationsBundle/index.html
1418+
.. _`DoctrineFixturesBundle`: http://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
1419+
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html

components/http_kernel/introduction.rst

+17-17
Original file line numberDiff line numberDiff line change
@@ -288,16 +288,15 @@ on the event object that's passed to listeners on this event.
288288
the Symfony Framework, and many deal with collecting profiler data when
289289
the profiler is enabled.
290290

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

302301
4) Getting the Controller Arguments
303302
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -395,14 +394,12 @@ return a ``Response``.
395394
.. sidebar:: ``kernel.view`` in the Symfony Framework
396395

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

407404
Additionally, a popular community bundle `FOSRestBundle`_ implements
408405
a listener on this event which aims to give you a robust view layer
@@ -699,3 +696,6 @@ look like this::
699696
.. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
700697
.. _`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
701698
.. _`PHP FPM`: http://php.net/manual/en/install.fpm.php
699+
.. _`SensioFrameworkExtraBundle`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
700+
.. _`@ParamConverter`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
701+
.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html

cookbook/controller/service.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -132,9 +132,8 @@ the route ``_controller`` value:
132132
.. tip::
133133

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

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

268267
.. _`Controller class source code`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
269268
.. _`base Controller class`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
269+
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/routing.html

cookbook/templating/PHP.rst

+4-3
Original file line numberDiff line numberDiff line change
@@ -60,11 +60,10 @@ below renders the ``index.html.php`` template::
6060
);
6161
}
6262

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

6666
// src/Acme/HelloBundle/Controller/HelloController.php
67-
6867
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
6968

7069
// ...
@@ -353,3 +352,5 @@ within an HTML context. The second argument lets you change the context. For
353352
instance, to output something in a JavaScript script, use the ``js`` context::
354353

355354
<?php echo $view->escape($var, 'js') ?>
355+
356+
.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view`

0 commit comments

Comments
 (0)